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LIMITED WARRANTY 


Xetec, Inc. warrants this Xetec hard disk drive known as the Lt. 
Kernal, to be in good working order for a period of one year from the 
date of purchase from Xetec, Inc. or an authorized Xetec dealer. 

Should this product fail to be in good working order at any time dur¬ 
ing this one year warranty period, Xetec will at its option, repair or 
replace this product at no additional charge except as set forth below. 
Repair parts and replacement products will be furnished on an ex¬ 
change basis and will be either reconditioned or new. All replaced 
parts and products become the property of Xetec, Inc. This limited 
warranty does not include service to repair damage to the product 
resulting from accident, disaster, misuse, abuse, or non-Xetec 
modification of the product. 

Limited warranty service may be obtained by delivering the product 
during the one year warranty period to an authorized Xetec dealer or 
to Xetec, Inc., and by providing proof of purchase date. Warranty will 
be valid for registered owners only. If this product is delivered by 
mail, you agree to insure the product or assume the risk of loss or 
damage in transit, to prepay shipping charges to Xetec, Inc., and to 
use the original shipping container or equivalant. Contact Xetec, 

Inc., 2804 Arnold Rd., Salina, Ks. 67401, (913)827-0685 for further 
information. 

All express and implied warranties for this product including the war¬ 
ranties of merchantability and fitness for a particular purpose, are 
limited in duration to a period of one year from the date of purchase, 
and no warranties, whether expressed or implied, will apply after this 
period. Some states do not allow limitations on how long an implied 
warranty lasts, so the above limitations may not apply to you. 

If this product is not in good working order as warranted above, your 
sole remedy shall be repair or replacement as provided above. In no 
event will Xetec be liable to you for any damages including any lost 
profits, lost savings or other incidental or consequential damages aris¬ 
ing out of the use of, or inability to use such product, even if Xetec or 
an authorized Xetec dealer has been advised of the possibility of such 
damages, or for any claim by any other party. 

Some states do not allow the exclusion or limitation of incidental or 
consequential damages for consumer products, so the above limitations 
or exclusions may not apply to you. 

This warranty gives you specific legal rights, and you may also have 
other rights which may vary from state to state. 
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The Lt. Kernal 


Welcome to the world of Serious Computing! 

PLEASE READ THIS MANUAL CAREFULLY 
BEFORE ATTEMPTING TO INSTALL YOUR LT. KERNAL! 

If the first few pages of section II of this manual seem a little stern, 
please understand — we want you to have the BEST possible service 
from your Lt. Kernal. The only way to let you know about the poten¬ 
tial for damage you could do to your system is to tell it like it is! 

You’ve invested in the most advanced disk system available for 
Commodore™ computers, and an incorrect installation may damage 
the Lt. Kernal, your computer, or both. Read the installation por¬ 
tion of this manual carefully before connecting together any parts of 
the system. 

The Lt. Kernal results from fifteen years of experience in designing 
large multi-user, multi-tasking mini-computer systems. We have ap¬ 
plied the technology used in those larger systems to improve the 
operating characteristics and speed of the C-64® and C-128® . 

Thank you for purchasing the Lt. Kernal. You now have at your 
fingertips really high speed computing power and a comfortable, user- 
friendly disk operating system that significantly upgrades the functions 
and usability of your Commodore computer. Quality software written 
with the user in mind, and rugged, conservatively designed hardware 
are combined to produce the best accessory ever for Commodore 
computers. 


Lt. Kernal is a registered trademark of Fiscal Information, Inc. 
C-64 and C-128 are reg. TM of Commodore Business Machines, Inc. 
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FCC STATEMENT 


This equipment generates and uses radio frequency energy and if not 
installed and used properly, that is, in strict accordance with the 
manufacturer’s instructions, may cause interference to radio and televi¬ 
sion reception. It has been type tested and found to comply with the 
limits for a Class B computing device in accordance with the specifica¬ 
tions in Subpart J of Part 15 of FCC Rules, which are designed to 
provide reasonable protection against such interference in a residential 
installation. However, there is no guarantee that interference will not 
occur in a particular installation. If this equipment does cause in¬ 
terference to radio or television reception, which can be determined by 
turning the equipment off and on, the user is encouraged to try to cor¬ 
rect the interference by one or more of the following measures: 

• Reorient the receiving antenna 

• Relocate the computer with respect to the receiver 

• Move the computer away from the receiver 

• Plug the computer into a different outlet so that computer and 
receiver are on different branch circuits. 

If necessary, the user should consult the dealer or an experienced 
radio/television technician for additional suggestions. The user may 
find the following booklet prepared by the Federal Communications 
Commission helpful: “How to Identify and Resolve Radio-TV In¬ 
terference Problems.” This booklet is available from the U.S. Govern¬ 
ment Printing Office, Washington, D.C., 20402, Stock No. 
004-000-00345-4. 


MANUFACTURER’S WARNING: Using a cable between the “Host 
Adaptor” and the “Hard Drive Assembly”, other than that provided 
by Xetec Inc. may result in interference to radio and television 
reception. 



I. 

The Lt. Kernal Disk Operating System V6.1 


DOS FEATURES 

• Runs most copy-protected software 

• Built-in KEYED INDEXED-RANDOM ACCESS METHOD 

• Supports both C-128 and C-64 modes of operation 

• 42 additional or enhanced system commands 

• Disk access speed more than 100 times faster than the 1541 floppy 

• Automatic power-up execution of any application program 

• Built in CP/M™ - like command line features 

• User configurable system characteristics such as screen and character 
colors, and logical drive sizes 

• Up to eleven logical drives may be defined on the hard disk 

• DOS allows up to seven files to be OPEN for reading and writing 
simultaneously in addition to the command/error channel 

• DOS differentiates between BASIC and machine language programs 

• Built-in backup and restore facilities 

• Direct invocation of programs from the READY prompt 

• Standard capacity of 20 Megabytes 
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TECHNICAL SPECIFICATIONS 


Standard capacities, Formatted 

Bytes per sector 
Sectors per track 
Tracks per cylinder 
Number of cylinders 

Media size 

Recording density 
Track density 

Transfer rate to C-64 memory 
Transfer rate to C-128 memory 
Rotational speed 
Average latency time 

Positioning time 


Power consumption 

20 Meg. SCSI Drive unit 
117 Volts A.C. 60 Hertz 

Host Adaptor 

+5 Volts D.C. 

Size 

20 Meg. SCSI Drive unit 
Weight 

20 Meg.SCSI Drive unit 


20 Megabytes 



4 

626 

51*” (13.3 cm) 

10,200 Bits/inch 
300 tracks/inch 

38,000 Bytes/sec 
65,000 Bytes/sec 
3,600 RPM 
8.3 ms 

18 ms min. 

192 ms max. 
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II. 

INSTALLATION 


CAUTION! 

Unless your Lt. Kemal hard disk system is specifically labeled 
otherwise, your system has been factory wired for: 

115 volts A.C. 60 hertz only 

Do not plug the power cord into any other voltage or frequency 
outlet. 

For domestic American systems, the correct outlet type is the 
three prong grounded variety. Use of a three prong adapter in a 
two prong ungrounded outlet is strongly discouraged since such 
use presents a high shock hazard and may damage your system. 


CAUTION! 

Always handle your hard disk/power supply assembly with the utmost 
care. Mechanical bumps and shocks to the drive could irrepairably 
damage it. 

Never move or ship the drive without first conditioning it for shipping 
via the “ship” system command, described later in this manual. 

Never move the drive unless power has been off for at least 30 
seconds. 

Never ship the drive in any container except it’s original carton. 


INSTALLING THE LT. KERNAL 

Installation of the Lt. Kemal hardware takes only a few moments, but 
MUST be done carefully to avoid damage. For a typical system setup 
refer to FIG 1. Be gentle, and work slowly and deliberately, referring 
to the text frequently as you go. 
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Typical System 



Make sure power is completely turned off to all components of your 
computer and the Lt. Kemal!! 

SECOND 

NEVER, NEVER, plug or unplug any interconnection of the system 
with power applied!! 

THIRD 

Always remember the second rule or you will eventually destroy sonr 
component of your system. 
































BEFORE BEGINNING YOUR INSTALLATION OF THE 
LT. KERNAL, CAREFULLY CHECK YOUR COMPUTER FOR 
PROPER OPERATION WITHOUT THE LT. KERNAL 
INSTALLED. THIS WILL PREVENT FALSE 
INDICATIONS OF TROUBLE LATER. 


There are two possible installations of the Lt. Kemal. One is for the 
C-64 computer, and the other for the C-128. To utilize the 128 mode 
in the C-128, the C-128 adaptor board must be installed. Both installa¬ 
tions will void your computer’s warranty, as you will be required to 
open the computer case to install clips and/or an adaptor board. If you 
do not feel competent to do this installation properly, seek the 
assistance of a qualified computer technician. CAUTION: Read each 
step thoroughly first before proceeding. 

TOOLS REQUIRED: A #\ phillips screwdriver and possibly a T-10 
TORX driver plus needle nose pliers for the 64C inner shield and a 
small flat blade screwdriver. 

C-64 or C-64C INSTALLATION 

Step I - Remove screws on the bottom of the computer case, un-snap 
the upper keyboard section and carefully unplug the keyboard and in¬ 
dicator LED cables. Place this section aside for now. 

Step 2 - Locate the HIRAM and CAEC cable assemblies. Refer to 
FIGS 2 and 3 to find your model and attach the HIRAM clip to the 
lead indicated of resistor R44 and attach the CAEC clip to PIN 6 of 
chip U27. Be sure that the clip is not shorting to any of the adjacent 
pins of either chip. Secure both leads with small pieces of scotch tape 
and dress each end out the opening for the expansion slot on rear of 
computer. NOTE: On some models, the metal shield must first be 
lifted by removing the TORX screws as needed, and then un-twist the 
small metal tabs around the perimeter of the shield. Replace this shield 
after the above clips are installed. 

Step 3 - Install the keyboard section by first connecting the keyboard 
and LED cables and their lower section into place, snap case shut and 
install bottom screws into case. 

Step 4 - Locate the HOST ADAPTOR and push the HIRAM connec¬ 
tor onto the leftmost pair of pins of plug PI as shown in FIGS 2 and 
3. Push the CAEC connector onto the 4th set of pins from the left on 
plug PI again as shown in FIGS 2 and 3. The jumpers on the 3rd and 
5th sets of pins must also be in position as shown. The Host adaptor 
may now be inserted into the EXPANSION connector on the rear of 
the computer. 
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Step 5 - Locate the 25 pin SIGNAL cable, plug one end into the con¬ 
nector on the rear of the Host Adaptor and secure the cable with the 
attached screws. Refer to FIG 4. 



Step 6 - Attach remaining end of the 25 PIN SIGNAL cable to the 
HOST ADAPTOR INPUT connector of the HARD DISK enclosure. 
Again, secure the cable with the attached screws. Refer to FIG 5. 

Step 7 - Locate the AC POWER CABLE and plug female end into the 
AC POWER receptable of the HARD DISK enclosure. Make sure the 
Power Switch is in the OFF position and plug the male end into a pro¬ 
perly grounded 115 volt AC, 60 Hz outlet. Refer to FIG 5. 

Step 8 - Re-connect any other components to your system such as 
printers, floppy disk and other accessories. 

Step 9 - Refer to Power Application Sequence page 2-13. 
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Rear view of Lt. Kernal hard disk enclosure 



C-128 INSTALLATION 

Step 1 - Remove screws on the bottom of the computer case, un-snap 
the upper keyboard section and carefully unplug the keyboard and in¬ 
dicator LED cables. Place this section aside for now. 

Step 2 - Lift the metal shield by removing the TORX screws and un¬ 
twisting the metal tabs around the perimeter of the circuit board 
shield. Lay this shield aside for now. 

Step 3 - Locate the C-128 ADAPTOR and lay on top of the SHIELD 
as shown in FIG 7. CAUTION: Discharge yourself from potential 
static electricity by touching the metal SHIELD before proceeding to 
the next step. 

Step 4 - Locate chip U7 in FIG 6. Gently remove this chip from its 
socket by inserting a small flat blade screwdriver as shown and then 
carefully rotate or twist the blade left and right. DO NOT USE A 
PRYING ACTION! Once removed, check all pins for straightness, and 
proceed to next step. 

Step 5 - Carefully insert chip U7 into the socket provided on the 
C-128 ADAPTOR. CAUTION: Be sure PIN 1 of chip matches PIN 1 
of socket or indented end of chip matches indented end of socket. 

Refer to FIG 7. 
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Removal of chip U7 in C-128 



FIG. 6 
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Step 6 - Install the C-128 ADAPTOR into the socket vacated in Step 4 
as shown in FIG 8. CAUTION: Make sure pins on the bottom of 
adaptor board are in their proper positions before firmly seating into 
place. Press down firmly in the area shown to firmly seat the ADAP¬ 
TOR board in place. 

Step 7 - Refer to FIG 8 and locate HIRAM CABLE. Clip this cable 
to PIN 23 of Ull as shown and secure with a piece of scotch tape. Be 
sure that the clip is not shorting to any of the adjacent pins of Chip 
Ull. Plug the remaining end onto plug P2 of the C-128 ADAPTOR 
board as shown. (NOTE: The CAEC CABLE is not used in the C-128 
installation) 

Step 8 - Again refer to FIG 8 and locate the C-128 cable and take 
either one of the ends and position it so the flat ribbon is coming out 
of the top side of the connector. Now push this connector onto plug 
PI of the C-128 ADAPTOR board as shown making sure all ten pins 
are properly entering each hole on the socket. 


C-128 cable connections 



FIG. 8 
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Step 9 - Locate the HOST ADAPTOR and remove the two jumpers 
on plug PI as they will not be used in your C-128 installation. Push 
the remaining end of the C-128 CABLE onto plug PI again with the 
flat ribbon coming out on the top side of the connector. The HOST 
ADAPTOR may notbe inserted into the EXPANSION connector on 
the rear of your C-LE8. Dress or position the flat cable so it will allow 
you enough slack to remove your HOST ADAPTOR if necessary. 



Host Adaptor cable connections for C-128 
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Step 10 - Replace the metal shield on the C-128 main board being 
careful not to pinch or bind the C-128 CABLE. 


Step 11 - Install the keyboard sections by re-connecting the cables, 
snap case halves together, and install bottom screws in case. 


Step 12 - Locate the 25 pin SIGNAL cable, plug one end into the 
connector on the rear of the Host Adaptor and secure the cable with 


the attached screws. Refer to FIG 4. 


Step 13 - Attach remaining end of the 25 PIN SIGNAL cable to the 
HOST ADAPTOR INPUT connector of the HARD DISK enclosure. 
Again, secure the cable with the attached screws. Refer to FIG 5. 
Step 14 - Locate the AC POWER CABLE and plug female end into 
the AC POWER receptable of the HARD DISK enclosure. Make sure 
the Power Switch is in the OFF position and plug the male end into a 
properly grounded 115 volt AC, 60 Hz outlet. Refer to FIG 5. 

Step 15 - Re-connect any other components to your system such as 
printers, floppy disk and other accessories. 


Step 16 - Refer to Power Application Sequence page 2-13 
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POWER APPLICATION SEQUENCE 

Power should be applied to your Lt. Kernal/Commodore combination 
in a specific manner. 

Before you do power up your system, please remember that things are 
going to act a little differently than what you accustomed to seeing, so 
read this whole section before actually applying power. We want you 
to know what to expect BEFORE it happens. 


Follow the steps in this order: 

1. Monitor or television set. 

2. Printers, floppy disks, and any other accessories EXCEPT the 
Lt. Kernel hard-disk. 

3. The Lt. Kernal hard disk system. 

4. Finally, the Commodore computer itself. 


POWER REMOVAL SEQUENCE 



1. The Lt. Kernal hard disk system 

2. Printers, floppy disks, and any other still powered accessories, 
including your monitor or TV set. 

3. The computer. 
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m. 

ACTIVATING THE SYSTEM 


NOW IT ALL COMES TOGETHER! When you apply power to 
your system without the Lt. Kemal present, you ordinarily would ex¬ 
pect to see the Commodore BASIC power-up messages and then the 
BASIC ready prompt within just a couple of seconds of turn-on. 

That’s not going to happen ... at least not instantly. 

What will happen instead is this: 

As soon as the drive has run up to speed, you should see the red in¬ 
dicator on the front of the drive blink twice, just briefly. About three 
seconds after that, the light will come on solidly for one second while 
the Lt. Kemal copyright messages appear. If the volume control on 
your monitor or TV is turned up, you’ll hear a beep and see the new 
READY prompt with the drive’s device number and logical drive 
number included. On a C-128, you may see even more activity. If the 
Lt. Kemal is configured to power up as a C-64, you’ll see the screen 
blank again. The whole process repeats, finally to arrive at the C-64 
mode of operation. 

A lot went on to get to this point, and that’s why there’s a delay after 
you turn on the system. While you were waiting for the system sign- 
on message, and while the disk drive was running up to speed, a long 
series of system diagnostics took place — checking die Lt. Kemal 
Host Adaptor — testing the drive’s controller electronics — and final¬ 
ly, even testing the Disk Operating System software installed on your 
drive. 

If any one of the diagnostics along the way should fail, you’ll just see 
the regular Commodore sign-on without the Lt. Kemal message, and 
without the beep. If the tests do fail, please TURN THE SYSTEM 
OFF and turn directly to “TROUBLE-SHOOTING” in this manual. 

NOW CHECK YOUR CABLING AND WIRING - AND 
TURN ON YOUR SYSTEM. 

Then we’ll introduce you to your new DOS. 
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IV. 

OPERATING CONCEPTS 

n 

HOW IT WORKS 



The Lt. Kemal DOS was written with the business user in mind. 

Many comfortable and easy-to-use new features have been added to 
your Commodore disk operating system while still supporting most of 
the existing 1541 floppy commands. The only commands not supported 
have no appropriate use in this environment. Most existing applications 
written in BASIC will run unmodified under the Lt. Kemal DOS. 

Many machine language applications and utilities such as assemblers, 
editors, and ‘wedges’ will also operate normally under the Lt. Kemal’s 
control — but some programs will not run in cooperation with the Lt. 
Kemal. The reason lies in how the Lt. Kemal got its name, and in 
how it operates. 

In order to support the tremendous speed at which the Lt. Kemal 
operates, it was essential that the cartridge/expansion port be used to 
communicate with the hard disk. To do that, there has to be a body of 
programs run by the Commodore computer to control the cartridge 
port and the Lt. Kemal Host Adaptor itself. But we wanted the Lt. 
Kemal to operate without making you sacrifice any of the memory you 
were accustomed to using. That has been accomplished by making the 
DOS support programs run in RAM (a modified Kemal) on the Lt. 
Kemal Host Adaptor. Since the Commodore computer itself is running 
the DOS, a few “programming considerations” (discussed in a later 
section) must be observed in order not to disrupt the always-running 
DOS. 


n 
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V. 


n 


COMMANDS OVERVIEW and 
DOS FEATURES (review) 


n 


RUN MODE Features or Enhanced Commands 


autoaccess 

autostart 

bell 

COPY 

DELETEkey 

INPUT# 

INSERTkey 


LOAD 

OPEN 

PRINT# 

SAVE 

SCRATCH 

SEARCHkey 

SHUFFLE 


n 


DIRECT MODE 

Features or Enhanced Commands 

ACTIVATE 

FETCH 

AUTOCOPY 

ICQUB 

AUTODEL 

invoke 

BUILD 

L 

BUILDINDEX 

LOAD 

CHANGE 

LU 

CLEAR 

MERGE 

CONFIG 

OOPS 

COPY 

QUERY 

D 

RENUM 

DEL 

S 

DI 

SHIP 

DIR 

TYPE 

DUMP 

UPDATEDOS 

ERA 

FASTCOPY 

USER 
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DOS FEATURES 


• Runs most copy-protected software 

• Built-in KEYED INDEXED-RANDOM ACCESS METHOD 

• Supports both the C-128 and C-64 Modes of operation 

• 42 additional or enhanced system commands 

• Disk access speed more than 100 times faster than the 1541 floppy 

• Automatic power-up execution of any application program 

• Built-in CP/M™ - like command line features 

• User configurable system characteristics such as screen and character 
colors, and logical drive sizes 

• Up to eleven logical drives may be defined on the hard disk 

• The DOS allows up to seven files to be OPEN for reading and 
writing simultaneously in addition to the command/error channel 

• The DOS differentiates between BASIC and machine lanaguage 
programs 

• Built-in backup and restore facilities 

• Direct invocation of programs from the READY prompt 

• Standard capacity of 20 Megabytes 



VI. 

COMMAND SYNTAX DEFINITIONS 


Throughout the descriptions of the commands which follow, we will 

use certain conventions to describe the command syntaxes and 

responses. Here are the definitions of those conventions. 

• COMMANDS are always noted in UPPER-CASE. You enter 
commands from the keyboard, or include them in programs. 

• FEATURES are noted in LOWER-CASE. A feature is an enhanced 
or added mode of operation, not a command. 

• Within a command’s syntax description, capital letters indicate the 
COMMAND name as you must enter it. 

• Within a command’s syntax description, lower-case letters indicate 
FILE-names or parameters for the command. 

• A “_” symbol indicates_a_REQUIRED_space_in_the_ 

command_sy ntax. 

• Text within brackets indicates [optional parameters or file names]. 

• A ” symbol indicates—a—REQUIRED—hyphen—in—the— 
command—syntax. 

• A term “< range >” indicates a save range for the SAVE command 
where the range may be expressed either in decimal or hexidecimal 
as 

hexadecimal range < $hex start-hex end > inclusive 
decimal range <dec. start-dec. end> inclusive 

• An exclamation mark (!) appended to the end of a DIRectory listing 
line indicates that the file has been changed or modified since the 
last CLEAR or FASTCOPY was executed. 

• lfn is the Commodore ‘logical file number’ convention 

• dev refers to the hardware device number of the drive selected 

• sa is the Commodore ‘secondary address or channel number’ 

• lu refers to the logical drive number (not to be confused with 
hardware device number) which may accompany a LOAD, SAVE, 
or OPEN command. 
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• When used in the context of LUs or Logical Drives, a DIRECTORY 
is a list of the files stored on that LU. 

• user refers to a logical sub-directory number within a logical drive’s 
(LU’s) directory. 

• When used in the context of KEY files, a DIRECTORY is one of up 
to five LISTS of KEYS stored in a KEY file. 

• A KEY is a fixed length string stored in a KEY file which is 
associated with a RECORD NUMBER for use in indexing records 
within RELative files. 



VII. 

RUN-Mode Features and Commands 


n 

autoaccess 

_ feature 

Autoaccess allows transfer of a load request to the floppy disk when a 
file-not-found condition arises on the hard disk. 

If the hard disk is defined as device #8 (this is user definable), and the 
floppy is also defined as device #8, then all Commodore syntax 
LOAD’S will first be referred to the hard disk. If the file is not found, 
than an attempt to LOAD that same file from the floppy will be made. 

This feature may be disabled via CONFIG if it interferes with your 
application software. 


n 


n 
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autostart 

feature 


Mode: Power-up or hardware reset 

Autostart is almost self-explanatory. Simply stated, any program saved 
under the name “AUTOSTART” will be automatically loaded and run 
upon power-up or after a hardware reset. Autostart functions for both 
BASIC and machine language programs, and is one of the best 
features any turn-key business system can have available. 

Autostart may be overridden by holding down the space bar during a 
power-up or reset start. 
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Mode: Direct or Run 


bell 

feature 



Bell offers programmers a method of issuing an audible prompt in the 
C-64 (or 64 mode of the C-128) without having to maintain SID 
drivers in their programs. Any PRINT from BASIC or CHROUT from 
machine language of the ASCII Bell character [ CHR$(7) or hex. 07] 
will cause a beep on the monitor or television set if the BEEPER op¬ 
tion is selected by the user in the CONFIG mode described later. 
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DELETE key 

command _ 

Syntax: SYS 64628:2,lfn,directory,Stringvar,reel,rech,status 

Ifn is the logical file number of a KEY file already OPENed on the 
hard drive. 

directory is the number (1-5) of the selected key DIRECTORY within 
the KEY file. 

Stringvar contains the EXACT key you wish to delete. 

Reel and rech are the Low and High bytes of the EXACT double¬ 
precision record number associated with the key to be deleted. 

Status is the value returned from the SYS to indicate the success or 
failure of the DELETE to occur. 

Please see the KEY files usage examples in Section IX of this manual 
for detailed examples of DELETE key. 





INPUT # 
command 


Syntax: INPUT# lfn, stringvar 

lfn is the number of the desired file from which input will occur, 
stringvar is a string type variable into which the file data will be 
read. 

The syntax above is identical to the Commodore conventions. INPUT 
# has been enhanced to fix the ‘string too long’ error problem which 
occurs when strings longer than 88 characters are read from a file via 
the INPUT# command. 

On the HARD DISK ONLY it is now possible to input strings longer 
than 88 characters (up to 254 characters, maximum) from disk files. It 
is, however, up to the programmer to accommodate this process in a 
special manner. 

When INPUT# is requested of a string within a file which is longer 
than 88 characters, EACH INPUT# request will read the NEXT 88 
characters into stringvar. It will be up to the programmer to con¬ 
catenate subsequent INPUT# strings to reconstruct the original string 
written to the file. 

This ‘fix’ allows BASIC programmers to use the much faster INPUT# 
command in preference to GET# when reading data from disk files. 
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INSERT key 
command 


Syntax: SYS 64628:l,lfn,directory,Stringvar,reel,rech,status 

lfn is the logical file number of a KEY file already OPENed on the 
hard drive. 

directory is the number (1-5) of the selected key DIRECTORY within 
the KEY file. 

Stringvar contains the EXACT key you wish to insert. 

Reel and rech are the Low and High bytes of the EXACT double- 
precision record number to be associated with the key being inserted. 
Status is a value returned from the SYS to indicate die success or 
failure of the INSERT to occur. 

Please see the KEY-files usage examples in Section IX of this manual 
for detailed examples of INSERT key. 
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LOAD 

command 



Syntax: LOAD “[lu:]filename”,dev[,sa] 

dev is the drive selected 

sa is the secondary address where 

0 or none = BASIC load 
and 1 = machine-language load 


Mode: Director or Run 

on the hard drive, LOAD may be abbreviated to 
L_[”][lu:]filename[”] 

with optional quotation marks about the name and without specifying 
either device number or secondary address. 

when used in this abbreviated syntax, LOAD will load the file at its 
correct load address depending on the filetype. 

Example: L 1:MYFILE - LOADs the program MYFILE from the hard 
disk logical unit #1. 
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OPEN 

command 


Syntax: OPEN #lfn,dev,sa,‘ 4 [lu:]filename” 
lfn is the logical file number 

dev is the physical address (number) of the disk accessed 

sa is the DOS channel associated with this logical file (channel 15 is 

reserved for the command/error channel). 

Mode: Direct or Run 

OPEN retains exactly the same syntax as when used with the 1541 
floppy disk, but now allows up to SEVEN logical FILES regardless of 
type, to be OPEN for reading and writing simultaneously on the hard 
disk. The Commodore ROM operating system will allow you to have 
as many as three more files open on a floppy disk, as well, for a total 
of ten open files. 

Some 1541 file types occupy more than one channel when OPENed. 
All Lt. Kernal files use only one channel. This enhancement does 
NOT increase the open channel capability of the 1541 floppy disk. 


u 



PRINT# 

command 



Syntax: Identical to Commodore conventions 

Due to the enhancement to INPUT# it is now feasible to write BASIC 
programs which write strings as long as 254 characters to disk files. 
See INPUT#. 
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SAVE 

command 


Syntax: SAVE “[<range>][lu:]filename”,dev 

where dev is the disk selected onto which to save the file 
Mode: Direct or Run 

SAVE may be abbreviated on the hard disk (only in the Direct Mode) 
to 

S_[‘ ‘][ < range > ] [lu: ]filename[’ ’] 

without optional quotation marks about the filename and range, and 
without specifying the disk’s device number. 

Where < range > is specified, the range may be stated either in hex¬ 
adecimal or decimal and is an INCLUSIVE range. 

Examples: 

S <$2000-3FFF>MYFILE - saves the area of memory from Hex 
2000 through and including Hex 3FFF to the hard disk. 

SAVE “< 1024-4096 >MYFILE”, 8 - Saves the area of memory 
from decimal address 1024 through and including location 4096 to 
drive #8. 
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SCRATCH 

command 



Syntax: OPEN #lfn,dev,sa,“S[lu]:filename” 

Mode: Direct or Run via channel 15 

The SCRATCH command is available in the Run mode only via the 
command/error channel. 

Note that the colon following the LU number is NOT optional. 

In the Direct mode, the ERA command discussed later in this manual 
performs the SCRATCH function. 

SCRATCH deletes the NEXT file encountered on the hard disk which 
qualifies according to the filename. This mode differs from the 1541 
floppy disk equivalent in that the 1541 SCRATCH command deletes 
ALL filenames qualifying according to the filename given. 

This limitation may be overridden via CONFIG for applications which 
require pattern-match scratching capabilities. 
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SEARCH key 
command 


Syntax: match search SYS 

64628:3, lfn, directory, Stringvar, reel, rech,status 

greater-than search 

SYS 64628:4,lfn,directory,Stringvar,reel,rech,status 
less-than search 

SYS 64628:5,lfn,directory,Stringvar,reel,rech,status 

lfn is the logical file number of a KEY file already OPENed on the 
hard drive. 

directory is the number (1-5) of the selected key DIRECTORY within 
the KEY file. 

Stringvar contains the key for which you wish to search. 

On return from the SYS 

Reel and rech will contain the double-precision record number 
associated with the first key to satisfy die SEARCH criteria. 

Status will contain a value to indicate the success or failure of the 
SEARCH. 

Please see the KEY files usage examples in Section IX of this manual 
for detailed examples of SEARCH key. 



SHUFFLE key directory 
_command 



Syntax: SYS 64628:7,lfn,directory,Stringvar,recl,rech,status 

Ifn is the logical file number of a KEY file already OPENed on the 
hard drive. 

directory is the number (1-5) of the selected key DIRECTORY you 
wish to SHUFFLE. 

On return from the SYS 

Status will contain a value to indicate the success or failure of the 
SHUFFLE. 

Please see the KEY files usage examples in Section IX of this manual 
for detailed examples of SHUFFLE. 
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VIII. 

DIRECT-MODE FEATURES and COMMANDS 

n 

ACTIVATE 

_ command 

Syntax: ACTIVATE 

ACTIVATE totally erases an existing logical unit and creates a new 
‘BAM’ and ‘INDEX’. ACTIVATE also gives you the opportunity to 
create a DOS IMAGE FILE to enhance operating speed on LU’s 
physically distant from the DOS LU (lu 10). 

DO NOT USE THIS COMMAND UNTIL YOU HAVE 
THOROUGHLY READ AND COMPLETELY UNDERSTAND THE 
ACTIVATE and CONFIG PROCESSES. 

ACTIVATE and CONFIG are discussed in detail in the ‘PROGRAM¬ 
MING CONSIDERATIONS’ chapter (section IX) of this manual. 

See also the UPDATEDOS command discussed later in this section. 

n 
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AUTOCOPY 

command _ 

Syntax: AUTOCOPY 

This self-documenting command allows you to rapidly copy multiple 
files across LU and USER boundaries. 




8-2 



AUTODEL 

command 



Syntax: AUTODEL 

AUTODEL is self-documenting, and allows you to rapidly delete 
multiple files from a specified lu/user area. If you wish to delete ALL 
files from an existing LU, ACTIVATE is faster. 
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BUILD 

command 


Syntax: BUILD_filename,nrecs,reel 

filename is any legal 1541 filename 

nrecs indicates the number of records to be formatted (65535 max) 
reel indicates the length in bytes of each record (3072. max) 

The maximum allowable size of any one file on the Lt. Kemal system 
is 32768 hard disk blocks of 512 bytes, or 16.78 mega-bytes. 

BUILD is similar to the 1541 RELative-file formatting function in that 
it creates a relative file ‘formatted’ with a number of fixed length 
records. Unlike the 1541 which requires that you OPEN and POSI¬ 
TION within a relative file to format it, BUILD is a direct mode com¬ 
mand, and is EXTREMELY FAST. 

The Lt. Kemal will also format a relative file using the 1541 OPEN 
and POSITION syntaxes, but more slowly than when using BUILD. 



BUILDINDEX 

command 


Syntax: BUILDINDEX 

BUILDINDEX builds a KEY file with up to five DIRECTORIES of 
keys. Necessary information about the file will be requested by 
BUILDINDEX as required. 

You will first be requested to supply the name of the new KEY file to 
be built. 

You will then be requested to specify how many DIRECTORIES (lists 
of keys) the file will hold. Once a KEY file is built, the number of 
directories within it may not be changed. You must build at least one 
directory, and you are limited to five within any one KEY file. 

You will be requested to supply the KEY LENGTH for each direc¬ 
tory. This specifies the permanently fixed length of the key strings 
contained within each of the directories. Each directory’s key length 
may be different and may range from 1 to 30 characters. 

Once you have supplied the key length for the last directory specified, 
BUILDINDEX will create the KEY file. 

Please see the KEY file usage examples in Section IX of this manual 
for detailed examples BUILDINDEX. 
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CHANGE 

command 


Syntax: CHANGE_[lu:]filename 

CHANGE allows you to change several characteristics of a file. You 
may CHANGE the: 


Filename 
User number 
Load address 

‘Dirty flag’ (archiving bit) 




CLEAR 

command 



Syntax: CLEAR 

CLEAR permits you to clear the ‘dirty-flags’ of all files in a specified 
LU/USER area. CLEAR will request the LU and USER parameters 
from you at the appropriate time. To clear the dirty-flag for a single 
file, use the CHANGE command. 

Dirty-flags (archiving bits) are the mechanism the Lt. Kemal uses to 
do archival backups to floppy disk. Whenever a file is either created 
or modified, the Lt. Kemal sets a ‘flag’ bit in that file’s directory en¬ 
try saying that the file has been modified. Only performing a backup 
copy of the file via FASTCOPY, or executing the CLEAR command 
will erase that bit. Files with the archiving bit set may be selectively 
listed with DIR by using the C option. 
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CONFIG 

command _ 

Syntax: CONFIG 

CONFIG allows the user to establish custom system characteristics 
such as screen and character color. Once these characteristics are set, 
the system will come up from power-on or a hardware reset with the 
selected characteristics in effect. 

System characteristics affected are 

C-64 Screen color 
C-64 Border color 
C-64 Character color 
C-128 Screen color 
C-128 Character color 
Default device # 

Default LU # 


Default USER # 

Beep 

scratch override 
Logical drive sizes 
Power-up mode (64-128) 
‘FAST’ modes (64/128) 
Printer codes 


Detailed use of CONFIG is included in section IX of this manual. 



COPY 

command 


Syntax: COPY_[”][lu:][newfilename] = [lu:]oldfilename[”] 

Mode: Direct or Run 

COPY creates a new file copied from oldfilename into newfilename. 
Copy will copy files across logical unit (logical drive) boundaries to 
the currently active subdirectory (user #). 

COPY is available in the RUN Mode only through the Command/Er¬ 
ror channel (15) using the standard Commodore 1541 syntax. COPY 
does not support copies with concatenation of multiple source files. 
The syntax in RUN mode is: 

OPEN lfn,dev, 15/ ‘C[lu] .destfile=[lu:]sourcefile’ ’ 

Note that almost all the COPY parameters are optional. Several syn¬ 
taxes will accomplish a COPY of a file. 

1. COPY THISFILE=THATFILE 

will copy the file named THATFILE into a new file called 
THISFILE on the logical drive on which you are currently 
working. 

Now assume that you are ‘logged’ (working) on LOGICAL DRIVE #1 
and working in User sub-directory 12 (1:12:). 

2. COPY 2:THISFILE=THATFILE 

will copy the file named THATFILE from logical drive 1 into a 
new file called THISFILE on logical drive #2, User #12 (2:12:). 

3. COPY 2:=THATFILE 

will copy the file named THATFILE from logical drive 1 into a 
new file of the SAME name on logical drive #2, subdirectory 12. 

4. COPY 2:=3:THATFILE 

will demonstrate the ability to copy from and to logical drives on 
which you are NOT logged. The syntax above will copy 
THATFILE from logical drive #3 to logical drive #2, subdirectory 
#12 even though you are currently working on logical drive #1. 

5. COPY =3:THATFILE 

will copy THATFILE from logical drive #3 to your currently 
logged logical unit (2) and currently working subdirectory (12). 

The optional quotation marks in the syntax definition for COPY are 
allowed so that graphics characters may be included in the filenames. 
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D 

command 


Syntax: D[_drvnum] 

drvnum is the desired hardware device number of the hard disk 

D is used to temporarily change the device number of the hard disk 
from the CONFIGured default. D typed without a drive number will 
cause the device number to revert to the power-on default. 
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DEL 

command 



Syntax: DEL_line number or 

DEL_[beg. line] - [end. line] 

DEL deletes BASIC program lines in memory. When the hyphen is 
used to indicate a range-delete, at least one line number must be 
given, (either beginning or end) to satisfy the range calculation. 


n 
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DI 

command 


Syntax: DI 

DI (display index) is a self-documenting command. DI displays all of 
the active keys in the directories of a KEY file. 

Please see the examples of KEY file usage in section IX of this 
manual for detailed use of DI. 

FILE TYPE DEFINITIONS 

The Lt. Kemal DOS supports the Commodore conventions for file 
type, such as “SEQ”, “REL”, etc., but uses within its own opera¬ 
tions a more finely divided set of file definitions. Each Lt. Kemal file 
type is assigned a numeric type. The types are: 

TYPE DEFINITIONS 

1 CONTIGUOUS DOS system file 
(i.e. INDEX and DISCBITMAP) 

2 CONTIGUOUS DOS system processor 
(i.e. DIR) 

3 RANDOM DOS external system 
processor (i.e. RENUM) 

4 KEY file for indexed RELative files 
(supports 5 key directories) 

5-10 UNASSIGNED 

11 BASIC language program file 
stored block-list random 

12 MACHINE LANGUAGE program file 

stored block-list random 

13 SEQUENTIAL FILE (i.e. editor text) 

stored block-list random 

14 USER FILE 

15 RELATIVE FILE 




k.J 
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DIR 

command 


Syntax: DIR_[[lu:[user:]]:[Tfiltyp][P][S][A][G][C]_][filename] 

DIR is a powerful directory command that allows a directory of the 
hard disk to be listed or optionally printed. Listings based on file type 
or file name matches with wild-cards and don’t-care characters are 
supported. You may use either trailing OR leading wildcards in the 
filename specification. The options are: 

lu requests the logical drive ft from which the DIRectory will be read 
user requests the subdirectory on the requested lu. 

Tfiltyp (type) filtyp is the numeric hard disk file type. 

P (print) causes die listing to be printed 
S (sort) causes the listing to be alphabetized 
A (all users) lists from all subdirectories on the requested LU 
G (global) lists from all subdirectories of ALL LU’s 
C (changed) lists only those files Changed or Created since the last 
backup or CLEAR command was issued. The directory listing for any 
file which reflects a ‘changed’ status will have an exclamation mark (!) 
appended to the end. 

The options may be used singly or combined in any order except that 
the options’ field must precede the file name specification, and that 
the G and A options override the optional user #, and G automatically 
implies the A option. 

Examples: 

DIR - causes a screen listing of all hard disk files in the current 
LU/USER area in which you are operating. 

DIR :P - causes a printed directory of all hard disk files in the current 
subdirectory and LU. 

DIR 1:4: MYFI - causes a directory of all files on LU 1 under sub¬ 
directory #4 whose names begin with the sequence ‘MYFI’. Note that 
the trailing **’ is IMPLIED, and does not need to be entered. 

DIR :T4A - causes a directory of all type 4 (KEY) files in all sub¬ 
directories of the current LU. 

DIR :SG - causes a directory of ALL files on ALL LU’s to be listed 
in alphabetic order. 

DIR *.ASM - causes a directory of all files whose names contain the 
string ‘.ASM’ anywhere after the first character. 

DIR :C - causes a directory from the currently active LU and USER 
subdirectory of all files which have been Created or Changed since the 
last backup or CLEAR. 
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-FULL OPTIONS EXAMPLE- 


This example uses all the options which may be meaningfully 
combined. 

Example: 

DIR :T11SPGC ?YFIL* - causes an alphabetized, printed directory of 
all BASIC programs on the hard disk which were created or modified 
since the last backup or CLEAR, the first character of whose names 
we do not care and whose names’ next four characters are ‘YFIL’. 


O 



DUMP 

command 


n 


Syntax: DUMP_[range_][lu:]seqfile 

range is the range of basic lines to dump in the form 
startline#-endline#. 

seqfll is the filename of the desired new text file to be created. 

DUMP causes a new sequential file to be created then writes the de- 
tokenized version of the BASIC program in memory into the sequen¬ 
tial file. 

DUMP turns BASIC programs into editable text files. 

Example: 

DUMP 200-250 1: my file 

would cause current BASIC lines 200 through and including 250 to be 
written to the SEQuential file MYFILE on hard disk logical unit 1. 



ERA 

command 


Syntax: ERA_[lu:[user:]]filename 

ERA erases (scratches) the NEXT file from the hard disk which 
qualifies according to the filename given. If the user: field is not sup¬ 
plied, then the file MUST exist on the currently active subdirectory, or 
the message “FILE BELONGS TO ANOTHER USER” will be 
issued, and the ERAse will be aborted. 

The ‘pattern-match scratch override’ discussed in CONFIG will not 
cause ERA to delete multiple files. If you wish to delete several files 
at once, then the AUTODEL command should be used. 
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FASTCOPY 

command 


n 


Syntax: FASTCOPY 

FASTCOPY is a self-documenting, menu driven file copy and 
backup/restore utility. FASTCOPY will only work properly on a Com¬ 
modore 1541 diskette drive (or fully compatible clone). 

FASTCOPY will allow you to 

• fast-format diskettes 

• perform multiple copies of diskettes rapidly 

• BACKUP your hard disk or an LU/USER area of your disk to 
diskettes rapidly 

• RESTORE your hard disk or an LU/USER area from diskettes 
rapidly. 

FASTCOPY will report any floppy diskette errors encountered during 
the copy process, but DOES NOT REPRODUCE DISKETTE ER¬ 
RORS ON THE DESTINATION DISKETTES. It is not intended for 
use as a ‘protected-disk’ copier. 


n 
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FETCH 

command 


Syntax: FETCH [lu:]filename 

filename is a SEQuential text file image of a BASIC program (created 
via DUMP). 

FETCH causes a text image of a BASIC program to be reloaded into 
memory in tokenized form for SAVEing as an actual program file. 
FETCH is the reciprocal command to DUMP. 

The use of these two commands in conjunction with one another 
allows the programmer to utilize the features of a text editor to revise 
and edit BASIC programs. 


O' 



(Image - Capturing Quick Utility Backup) 


ICQUB 

command 


Syntax: ICQUB or filename 

filename is the name of an auto-loader built by the ICQUB utility. 

ICQUB (pronounced ‘icecube’) permits you to capture and save to the 
hard disk certain copy protected software. 

SOFTWARE CAPTURED BY ICQUB CANNOT BE USED ON 
ANY OTHER COMMODORE COMPATIBLE DISK DRIVES. 

ICQUB is designed NOT to be a ‘pirating tool’. The ‘copies’ it creates 
of protected software require the Lt. Kemal hardware to be present in 
order for them to run. 

ICQUB does allow you to back up many of your own(ed) copy pro¬ 
tected software packages on the Lt. Kemal. It does so by allowing you 
to load protected software into your computer from a floppy disk, then 
capturing a running image of the program. This technique will not 
allow you to run software which periodically re-checks its protection 
scheme, unless you are willing to have the protected disk in your flop¬ 
py disk drive continually while using the captured copy. 

Since ICQUB actually snap shots a running program, some software 
which appears not to work when ICQUB’d may work if you choose 
another time or stage of operation at which to capture the copy. Once 
a working copy is captured, it should work every time. Don’t give up 
on a package just because your first try didn’t produce a working pro¬ 
gram. Most software will ICQUB on the first try - but not all 
packages will. 

ICQUB is simple to use, and for the most part it is self-documenting. 
Be sure that you are logged on to the LU on which you wish the cap¬ 
ture to take place before invoking ICQUB. 

When you type the ICQUB command, you will be presented with a 
menu. You may: 

• Select from ICQUB files already on any LU 

• Run the ‘current’ (last) capture file on this LU 

• Assign a new name to the current capture file on this LU 

• Capture a new program via ICQUB on this LU 

• Return to Basic 

OPTION #1 

You will be presented with a files list similar to that which 
AUTODEL and AUTOCOPY produce from which to select your 
program. From this list you will also be permitted to select a file 
for which to build an ‘auto-loader’. Once built, the auto-loader may 
be directly invoked just by typing its name at the READY prompt. 
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OPTION #2 

You can test the current ICQUBCAPTUREFILE without bothering 
to search the list above. 

OPTION #3 

You may give ICQUBCAPTUREFILE a new name. Actually, 
ICQUBCAPTUREFILE is copied into the new file so that 
ICQUBCAPTUREFILE will not have to be re-built for option #4. 
The new filename will be your own selected 12 character name 
followed by the suffix “.ICQ” (i.e. MYFILECAPTUR.ICQ). 

OPTION #4 

You may capture a new program into ICQUBCAPTUREFILE. If 
ICQUBCAPTUREFILE does not exist on the currently logged LU 
when you select this option, it will be built. It may take as long as 
a minute to allocate capture space. Once the space is allocated, the 
computer will seem to ‘reset’, and return to a normal power-up 
screen, as if the Lt. Kemal were NOT present. 

This is the point at which you LOAD your protected software from 
the floppy disk. When the program has progressed to the point at 
which you wish to capture it, press the ICQUB button on your Lt. 
Kemal Host Adaptor. When the capture is complete, the Lt. Kemal 
will return to control. 

Here’s a brief hint on capturing. The ICQUB button performs much 
the same function as the RESTORE key on your computer. An exam¬ 
ple will show you how that affects captures. 

Let’s say you have a wordprocessor running which always returns to 
its ‘main menu’ when you press RUN/STOP and RESTORE 
simultaneously. The proper way to capture that software would be to 
allow it to get to a point where you COULD return to the main menu, 
then to hold down RUN/STOP and instead of pressing RESTORE, to 
then press the ICQUB button. 

When the captured version is run, it will go directly to the main 
menu! You will have to experiment. Each software package ICQUB’s 
a little differently. 

OPTION m 

You may return to BASIC. Things will be a little ‘messed-up’ if 
you attempt to get back to BASIC any way other than via option 
#5, and you’ll probably have to reset your computer to get back to 
proper operation. 
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invoke 

feature 



Syntax: filename 

Any legal filename typed beginning in the first column of the screen 
will cause the system to attempt to load and execute that file. The 
INVOKE feature works for both BASIC and machine language pro¬ 
grams. Simply type the program’s name, followed by a carriage 
return. 
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L or LOAD 

command _ 

Syntax: LOAD “[lu:]filename”,dev[,sa] 

dev is the drive selected 

sa is the secondary address where 

0 or none = BASIC load 
and 1 = machine-language load 

in the Direct-Mode, LOAD may be abbreviated to 
L_[”][lu:]filename[’ ’] 

with optional quotation marks about the name and without specifying 
either device number or secondary address. 

when used in this abbreviated syntax, LOAD will load the file at its 
correct load address depending on the file type. 

Example: L LMYFILE - LOADs the program MYFILE from the hard 
disk logical unit #1. 


'U 



LU 

command 


Syntax: LU[_lunumb] 

lunumb is the number of the logical unit on which you wish to begin 
operation. 

lunumb may range from 0-10 decimal. 

LU typed without a number following will log you onto the power-on 
default logical unit specified in CONFIG. 



MERGE 

command 


Syntax: MERGE_[lu:]filename 

filename is the name of any disk-resident BASIC program file. 

MERGE can actually merge or interleave the lines of the specified 
BASIC file on disk with the BASIC program currently in memory. If 
you wish to append basic files using MERGE, RENUMber one or 
both programs first so that the line numbers of the two do not conflict 
with or interleave one another. 

In the case of lines of the disk based program duplicating line numbers 
of the program in memory, the lines from disk will replace lines of 
the same numbers in memory. 





OOPS 

command 


Syntax: OOPS 

n OOPS will attempt to recover the LAST file ERAsed, SCRATCHED 
or SAVEd with replacement on the currently logged logical unit into a 
new file named OOPSFILE#. The # character will be replaced with a 
digit from 1 to 9. Up to 9 OOPSFILEs may be created before you 
MUST rename or delete some of them. 

If any disk activity has taken place that makes it impossible to recover 
the last file deleted, OOPS will report the file as unrecoverable. Only 
the LAST file deleted is ever OOPSable. 

It is important to remember that any SAVE or OPEN for writing or 
appending AFTER a file is accidentally SCRATCHED or ERAsed will 
make it impossible to recover the file via OOPS. 


n 


n 
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QUERY 

command 


Syntax: QUERY_[lu:]filename 

QUERY will tell you all the pertinent information about the file re 
quested. Depending on the file type of the file, the following file 


characteristics may be described: 

File size (hard disk blocks) 
USER # 

Commodore convention file type 

# records (REL files) 
load address 

# directories (KEY files) 


LU # 

Lt. Kemal numeric file type 
Hard disk file header address 
Record length (REL files) 

# keys/directory (KEY files) 

# of active keys (KEY files) 





RENUM 

command 


Syntax: RENUM[_incr[,newstart[,oldstart-oldend]]] 

incr is the desired line increment over the RENUMbered range of 
lines. 

newstart is the line number to be assigned to the first line of the 
RENUMbered range of lines. 

oldstart-oldend is the range of OLD line numbers which you wish to 
be RENUMbered. At least the hyphen and one old line number are re¬ 
quired to satisfy the range option, 
i.e. 10-500 (all lines between and including 10 and 500) 

or -350 (all lines from the start of the program up to and including 
line 350) 

or 510- (all lines after and including line 510) 

If you specify a SINGLE line number without the hyphen, the effect 
would be as if you had typed the range ‘oldstart-63999’. 

if no options are specified, the defaults will be set as if you had typed: 

RENUM 10,10,0-63999 

RENUM will renumber a BASIC program currently in memory. If no 
options are specified, the entire program will be renumbered. The 
renumbered program will begin with line 10 and line numbers will in¬ 
crement by 10. 

The options provide extremely powerful editing capabilities to BASIC. 
Proper use of the options will even allow blocks of code to be moved 
within a BASIC program. 

Any error in GOTO or GOSUB targets which would make renumber¬ 
ing impossible will cause an error message along with a listing of the 
line in which the error occurred. If any fatal renumbering error does 
occur, the BASIC program will be returned unmodified so that you 
may more easily debug the error. RENUM does not recognize the GO 
TO variant of GOTO. 

RENUM is very fast. A typically organized BASIC program 24 
Kbytes long takes about 14 seconds to renumber. Most BASIC pro¬ 
grams are not nearly that long, and routine RENUMbering of short 
programs is almost instantaneous. 

RENUM will NOT preserve a machine language tail on the end of a 
BASIC program. If you do RENUMber this sort of ‘hybrid’ program, 
you will have to manually re-link the machine lanaguage portion of it. 
Also, RENUM uses all of the BASIC space and parts of the memory 
under the BASIC ROM for line and target buffers. Any programs resi¬ 
dent in those areas at RENUMber time will be destroyed. 
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The options are powerful enough to be somewhat dangerous if used 
improperly, so some examples of RENUMber’s use are appropriate. 
Here is a review of the RENUM syntax. 


Syntax: RENUM[_incr[,newstart[,oldstart—oldend]]] 


example 1. RENUM 

Typing just RENUM without options will renumber the en¬ 
tire BASIC program in memory to a beginning line number 
of 10 and with line numbers incrementing by 10. 

example 2. RENUM 1 

will renumber the entire program to a beginning line 
number of 10 and with line numbers incrementing by 1. 

example 3. RENUM 2,5000 

will renumber the entire program to a beginning line 
number of 5000 with line numbers incrementing by 2. 

To demonstrate this command, the program: 

10 REM THIS IS A LINE NUMBERING EXAMPLE 
12 GOTO 15 
15 PRINT “HELLO” 

30 LET A=1:PRINT A:GOTO 10 
would be renumbered to this: 

5000 REM THIS IS A LINE NUMBERING EXAMPLE 
5002 GOTO 5004 
5004 PRINT “HELLO” 

5006 LET A=1:PRINT A:GOTO 5000 

example 4. RENUM 1,10,5000-5004 

To demonstrate this command, the program: 

5000 REM THIS IS A LINE NUMBERING EXAMPLE 
5002 GOTO 5004 
5004 PRINT “HELLO” 

5006 LET A=PRINT A:GOTO 10 
5008 END 

would be renumbered to this: 

10 REM THIS IS A LINE NUMBERING EXAMPLE 

11 GOTO 12 

12 PRINT “HELLO” 

5006 LET A=1:PRINT A:GOTO 10 
5008 END 



EXACTLY the same effect could have been produced by typing: 
RENUM 1,10,-5004 

You could complete the renumbering of the last result by 
typing: 

RENUM 1,13,5006- 

which would yield: 

10 REM THIS IS A LINE NUMBERING EXAMPLE 

11 GOTO 12 

12 PRINT “HELLO” 

13 LET A=1:PRINT A:GOTO 10 

14 END 

EXACTLY the same effect could have been produced by typing 

RENUM 1,13,5006-5008 or RENUM 1,10 

Now on to the very powerful and somewhat DANGEROUS subject of 
moving lines via RENUM. You can actually edit your BASIC pro¬ 
grams using the full options list of RENUM to cause groups of lines 
to be moved elsewhere in the program, but some cautions need to be 
kept in mind. 

FIRST, if you plan to move lines about in your program, SAVE a 
current copy to disk before you start the changes. It is possible to ac¬ 
cidently overwrite lines by mis-specifying options. 

SECOND, if you actually PLAN to overwrite some lines, remember 
that the lines PHYSICALLY encountered LAST in the renumbering 
process will overwrite any lines of the same numbers which were en¬ 
countered earlier. Some examples will clarify this process. 

example 5. Take the following program: 

10 GOSUB 70: PRINT A 

20 PRINT “THIS IS A BLOCK-MOVE EXAMPLE” 

30 INPUT A 
40 PRINT A 

50 IF A < 10 THEN GOTO 110 
60 GOTO 120:REM JUMP OVER SUBROUTINE 
70 PRINT “THIS IS A FAVORITE SUBROUTINE OF 
MINE” 

80 PRINT “WHICH I SHOULD REALLY MOVE 
OUT OF THIS” 

90 PRINT “AREA OF THE PROGRAM” 

100 A=0:RETURN 

110 PRINT “A IS LESS THAN 10” 

115 GOTO 130 

120 PRINT “A IS GREATER THAN OR EQUAL TO 10” 

130 END 
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typing RENUM 1,5000,70-100 would yield: 


10 GOSUB 5000: PRINT A 

20 PRINT “THIS IS A BLOCK-MOVE EXAMPLE” 

30 INPUT A 
40 PRINT A 

50 IF A < 10 THEN GOTO 110 

60 GOTO 120:REM JUMP OVER SUBROUTINE 

110 PRINT “A IS LESS THAN 10” 

115 GOTO 130 

120 PRINT “A IS GREATER THAN OR EQUAL TO 10” 
130 END 

5000 PRINT “THIS IS A FAVORITE SUBROUTINE OF 
MINE” 

5001 PRINT “WHICH I SHOULD REALLY MOVE OUT 
OF THIS” 

5002 PRINT “AREA OF THIS PROGRAM” 

5003 LET A=0:RETURN 


The lines from 70 through 100 actually moved. Be careful, though, 
because this process could also modify your program’s flow. 

We could INTENTIONALLY overwrite part of the program like this: 


Taking the same original program as above: 

10 GOSUB 70:PRINT A 

20 PRINT “THIS IS A BLOCK-MOVE EXAMPLE” 

30 INPUT A 
40 PRINT A 

50 IF A< 10 THEN GOTO 110 
60 GOTO 120:REM JUMP OVER SUBROUTINE 
70 PRINT “THIS IS A FAVORITE SUBROUTINE OF 
MINE” 

80 PRINT “WHICH I SHOULD REALLY MOVE OUT 
OF THIS” 

90 PRINT “AREA OF THE PROGRAM” 

100 A=0:RETURN 

110 PRINT “A IS LESS THAN 10” 

115 GOTO 130 

120 PRINT “A IS GREATER THAN OR EQUAL TO 10” 
130 END 




Typing RENUM 10,10,70-100 would yield 



10 PRINT “THIS IS A FAVORITE SUBROUTINE OF 
MINE” 

20 PRINT “WHICH I SHOULD REALLY MOVE OUT 
OF THIS 

30 PRINT “AREA OF THE PROGRAM” 

40 A=0:RETURN 

50 IF A < 10 THEN GOTO 110 

60 GOTO 120:REM JUMP OVER SUBROUTINE 

110 PRINT “A IS LESS THAN 10” 

115 GOTO 130 

120 PRINT “A IS GREATER THAN OR EQUAL TO 10” 
130 END 


Note that the original lines 10-40 were overwritten by old lines 
70-100. More specifically, since lines 70-100 were encountered LAST 
in the program with the new line numbers 10-40, they took 
precedence, and overwrote any earlier encountered lines of the same 
numbers. 


As a final example of the same effect, let’s take example 5 program 
once more: 

10 GOSUB 70:PRINT A 

20 PRINT “THIS IS A BLOCK-MOVE EXAMPLE” 

30 INPUT A 
40 PRINT A 

50 IF A < 10 THEN GOTO 110 
60 GOTO 120:REM JUMP OVER SUBROUTINE 
70 PRINT “THIS IS A FAVORITE SUBROUTINE OF 
MINE” 

80 PRINT “WHICH I SHOULD REALLY MOVE OUT 
OF THIS” 

90 PRINT “AREA OF THE PROGRAM” 

100 A=0:RETURN 

110 PRINT “A IS LESS THAN 10” 

115 GOTO 130 

120 PRINT “A IS GREATER THAN OR EQUAL TO 10” 

130 END 



8-31 



Typing RENUM 10,70,10-40 would yield: 


50 IF A < 10 THEN GOTO 110 
60 GOTO 120:REM JUMP OVER SUBROUTINE 
70 PRINT “THIS IS A FAVORITE SUBROUTINE OF 
MINE” 

80 PRINT “WHICH I SHOULD REALLY MOVE OUT 
OF THIS” 

90 PRINT “AREA OF THE PROGRAM” 

100 A=0:RETURN 

110 PRINT “A IS LESS THAN 10” 

115 GOTO 130 

120 PRINT “A IS GREATER THAN OR EQUAL TO 10” 
130 END 



The lines 10-40 WERE actually renumbered to the range 70-100, but 
since other lines of the same range were encountered LATER in the 
renumbering process, they were replaced. 

We could have protected against accidental overwriting of lines, but 
the power of having that capability strongly outweighs the dangers. 
We do suggest, though, that you be VERY careful with the range op¬ 
tion of RENUM until you become comfortable with what it can do. 

Any time lines are moved with RENUM, the message 

‘RE-ORDERING DISPLACED LINES’ 

will appear. If the program is quite large and the lines have moved to 
very near the beginning of the program, the re-ordering process could 
take several minutes. 
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s 

command 



Syntax: S 

The S command is a special direct-mode implementaion of SAVE. S 
allows easy and fast re-saving with replacment of a BASIC program 
presently being edited. 

For any BASIC program which has been LOADed (via LOAD or the 
L command) and edited, merely typing S and carriage return will 
cause the program to be re-SAVEd under the original file name. Also 
see SAVE command for the abbreviated S syntax with a file name 
supplied. 
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SAVE 

command _ 

Syntax: SAVE “[<range>][lu:]filename”,dev 
dev is the disk selected onto which to save the file. 

SAVE may be abbreviated in the Direct-mode to: 

S_[‘ ‘] [ < range > ][lu:]filename[‘ ‘] 

with optional quotation marks about the filename and without specify¬ 
ing the disk’s device number. 

Where < range > is specified, the range may be stated either in hex¬ 
adecimal or decimal and is an INCLUSIVE range. 

Examples: 

S < $2000-4000 >MYFILE 

—saves the area memory from Hex 2000 through and including Hex 
4000 to the hard-disk. 

SAVE “< 1024-4096>MYFILE”,8 

—saves the area of memory from decimal address 1024 through and 
including location 4096 to drive #8. 





SHIP 

command 



Syntax: SHIP 

SHIP causes the hard disk’s heads to be moved to the proper zone for 
shipping. THIS COMMAND MUST BE EXECUTED PRIOR TO 
MOVING OR SHIPPING YOUR HARD DRIVE. 

Simply type SHIP and carriage return, and wait for the drive 
“PREPARED FOR SHIPPING” message. TURN YOUR LT. KER- 
NAL HARD DISK OFF and wait thirty seconds for all mechanical ac¬ 
tivity to cease. 

You may then transport the system. 
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TYPE 

command 


Syntax: TYPE_[lu:]filename 

TYPE causes a BASIC file specified in the filename to be listed to the 
screen WITHOUT disturbing the present contents of BASIC memory. 

The TYPE command is very valuable for extracting portions of disk- 
resident BASIC programs for use in a program presently being edited. 






UPDATEDOS 

command 



Syntax: UPDATEDOS 

UPDATEDOS updates the DOS image files which you may have in¬ 
stalled on various LUs. It is only required to be run after one or more 
LU partitions have been created via CONFIG. Please see the section 
CONFIG for more detail on this command and DOS image files. 


n 


n 
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USER 

command 


Syntax: USER]_user#] 

user# is a decimal number in the range 0-15 

USER causes you to be ‘logged’ into the requested subdirectory of the 
LU on which you are currently working. Subsequent DIR’s, SAVE’s, 
or COPY’S will be directed to/ffom the requested subdirectory sup¬ 
plied in the user# field. USER typed without a specified # will cause 
you to log into the CONFIGured power-up default subdirectory. 




IX 

PROGRAMMING CONSIDERATIONS FOR 
THE LT. KERNAL DOS 


The Lt. Kemal DOS was written specifically to satisfy the needs of 
the business or scientific software developer and to supply an excellent 
target system on which that new software might be run. In almost 
every instance, BASIC programs developed for the 1541 floppy disk 
will operate under control of the Lt. Kemal DOS. Machine language 
programs require some special precautions to be completely inter- 
changable between the Lt. Kemal system and a 1541 environment. 

Both BASIC and machine language programs can benefit from the 
‘speed tip’ offered later in this section. Limitations on machine 
language and BASIC programs are few and well defined at the time of 
the writing of this manual. 

Here are some general precautions to observe when programming the 
Lt. Kemal system: 

1. BASIC programs should be modules which DO NOT contain 
machine language ‘auto-boot’ code at addresses lower than the 
‘normal’ BASIC start address. Low memory auto-loaders can be 
used, but programs containing them CANNOT BE DIRECTLY 
INVOKED; they must be loaded via LOAD or L to function. 

Machine language ‘tails’ appended to the end of BASIC programs 
are perfectly acceptable. BE AWARE, however, that various com¬ 
mands such as RENUM, MERGE, and FETCH will destroy or 
modify the machine language parts of such ‘hybrid’ programs. The 
machine language portions of such software will have to be re¬ 
linked to the BASIC portion after the BASIC portion has been 
edited. (This same limitation occurs in a 1541 environment) 

2. Machine language programs should not modify the stack pointer. 
This practice, although frequently used, is generally considered by 
professionals to be a programming ‘trick’, and is not considered to 
be good programming practice. With the Lt. Kemal in control, 
modifying the stack pointer (other than by balanced pushes and 
pulls) will nearly guarantee that the Lt. Kemal cannot properly in¬ 
tercept disk service requests. There ARE ways around this and we 
encourage you to experiment CAREFULLY. 
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3. Machine language programs should always use the ‘KERNAL 
VECTORS’ to request system or disk service. The KERNAL 
VECTORS are a set of indirect jumps or JSR’s to various KER¬ 
NAL ROM routines. When the computer ROM operating system 
was written, it was intended that programmers use these vectors if 
they wished to use ROM subroutines. The Lt. Kemal DOS sup¬ 
ports that convention. 

Although you are free to use ROM routines by JMPing or JSRing 
to undocumented entry points within ROM, we cannot guarantee 
that hard disk requests will be properly intercepted by the Lt. Ker- 
nal DOS unless you use ONLY the KERNAL VECTORS for such 
requests. 

4. The Lt. Kernal DOS intentionally does NOT support RANDOM 
reads and writes to the hard disk by track and sector. The ‘U’ er¬ 
ror channel commands are not supported to prevent damage to the 
DOS itself. We can provide other secure ways to protect pro¬ 
prietary software on the Lt. Kemal to authorized third-party soft¬ 
ware developers. 


BACKUP COPYING 

Any system of software worth using is also worth protecting. Backup 
copying is the only method available to secure your programs and data 
against loss. 

We have expended every effort to make sure that the Lt. Kemal DOS 
and the hard disk system hardware will be reliable. Even with that 
effort, WE CANNOT ASSURE that your system will not fail some¬ 
day. If the system does fail, it is possible that any data or programs on 
the hard disk at the time of the failure will be lost. 

COPY YOUR IMPORTANT FILES TO DISKETTE as often as 
necessary to enable you to recover in case your files are lost or 
accidentally erased. We have provided methods for you to perform 
backup copying. 

For a moment, let’s discuss the PROPER way to keep backups of your 
system in order to minimize the chances of losing any data. The cor¬ 
rect process is sometimes known as ‘DOUBLE GRANDFATHERING’ 
or ‘ALTERNATE’ backup. 

Say for discussion’s sake that you do daily backup’s (if you’re keeping 
business data on your hard disk, you should!). On Monday evening, 
you copy your system and label die diskettes ‘MONDAY’. After Tues¬ 
day’s work, it’s time for another copy to be done. On Tuesday even¬ 
ing, you MUST USE A NEW SET OF DISKETTES. 



Rule 1 

NEVER, NEVER, NEVER, NEVER DESTROY your MOST 
RECENTLY SUCESSFUL BACKUP!!! 

Once you have completed Tuesday’s copy, you label the diskettes 
‘TUESDAY’ and store them as well in a different physical location 
than Monday’s copy. 

Rule 2 

ALWAYS STORE ALTERNATE BACKUPS IN DIFFERENT 
PHYSICAL LOCATIONS (preferrably in different buildings). 

This is simply to ensure that even a catastrophy like a fire would only 
lose for you at the most TWO working days of data. 

On Wednesday, you can re-use Monday’s diskettes; Tuesday’s copy is 
now your most recent backup and is the one which must be protected 
most carefully. Each day you alternate sets of diskettes. 

If you do serious business processing on your Lt. Kemal, make up 
two sets of labels for your two (at least two) backup copies. Make 
each set a different color. Next, make a calendar of your copying 
schedule, marking the COLOR of the set to be used on each data pro¬ 
cessing day. Make sure you truly alternate colors. 

For instance: If you started this Monday with RED and you work five 
days a week, NEXT Monday had better be a BLUE day (no pun in¬ 
tended). Mark your calendar for about a month in advance then stick 
to it faithfully. 

IF YOU HAVE A REAL DATA EMERGENCY AND HAVE 
FOLLOWED YOUR BACKUP SCHEDULE, YOU ARE RELATIVE¬ 
LY SAFE — BUT - IF A HARDWARE PROBLEM IS WHAT 
DESTROYED YOUR DATA — DON’T RISK A GOOD COPY OF 
YOUR DATA FOR ANY REASON UNTIL YOU ARE SURE THE 
PROBLEM IS COMPLETELY SOLVED AND THE SITUATION IS 
SAFE. 


Floppy disk copying is just plain slow. To help relieve the slow disk 
pains, we have provided a program called FASTCOPY which is 1541 
specific to copy to and from floppy disks more quickly. FASTCOPY 
will copy a full diskette by filename in about two minutes. Even at 
that speed, and swapping diskettes as fast as your hands can move, it 
takes about four HOURS to copy a full twenty megabytes. Usually, 
though, your disk won’t be completely full, so the copy will take less 
time than that. FASTCOPY is self documenting: Just follow its in¬ 
structions. Remember, though that FASTCOPY is designed just for 
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Commodore 1541 disk drives. If you own another brand or model, 
you may have to resort to a program such as ‘COPY-ALL’ (supplied 
on 1541 distribution diskettes). COPY-ALL works fine but takes a 
LONG time to copy 20 megabytes (we won’t scare you with HOW 
long). 

If your Lt. Kemal disk system is full, our FASTCOPY utility offers a 
nice alternative copying feature which is safe as long as it is used with 
discretion. This feature is ARCHIVAL COPYING. 

Archival copying is nothing more than the process of copying only 
those files which were modified since the last copy was done. Your 
copy takes less time because there are fewer files to copy. AR¬ 
CHIVAL copying does have a pitfall. 

Unless you keep EVERY consecutive archival copy you’ve ever made 
since the last COMPLETE copy of your system, you might not be 
able to recover from a major data loss. The solution is simple: 
Establish a regular schedule during which you normally do AR¬ 
CHIVAL copies, but in which you also do COMPLETE copies at 
regular intervals. 

A good regimen to follow is: 

A COMPLETE copy of ALL FILES once a week (or two weeks 
according to the importance of your data 

and 

Archival copies every day or so between the complete copies. 

Make sure to label and retain ALL the archival copies made until you 
have safely made a complete copy. 

Again, FASTCOPY is self-documenting, and will take you through 
either a complete or archival copy automatically. 

PLEASE BACK UP YOUR DATA 
AND PROGRAMS REGULARLY 

With a hard disk’s tremendous capacity, any data loss can be a HUGE 
data loss. Backing up regularly will protect you. 


Directly Invoked Applications 

With the Lt. Kemal DOS in effect, you can cause any program to be 
loaded and run simply by typing its name and pressing ‘RETURN’. 
There are just a few precautions you must observe in order to make 
sure your programs may be directly invoked. 



BASIC programs are no problem at all. Any BASIC program (and 
most compiled BASIC programs) will run unmodified under the direct 
invocation feature of the Lt. Kemal DOS. Machine language programs 
require that three constraints be observed. 

1. Machine language routines must have the same LOAD address and 
ENTRY POINT (the address to which you would normally SYS). 
Even if a routine you wish to directly invoke does not meet this re¬ 
quirement, it is a simple task for any machine language (assembly 
language) programmer to ‘patch’ your program to meet this 
specification. 

2. The routine MUST NOT over-write the ‘stack’ (memory addresses 
$0100-$01FF). Some ‘AUTO-BOOT’ loader programs do write 
over this area of the computer’s memory, and they cannot be direct¬ 
ly invoked. They will only work by LOADing them with the FULL 
Commodore LOAD syntax. 

ANY routine must use the ‘KERNAL VECTORS’ (between $FFCO 
and $FFFF) for any system calls which require disk access. This re¬ 
quirement was set down by Commodore Business Machines when they 
provided the BASIC operating system in your computer and the Lt. 
Kemal DOS adheres to that standard. 

AUTOSTART applications should follow the same guidelines as 
Directly Invoked applications. 


‘STACK’ manipulation 

It is usually considered a programming ‘trick’, and not good practice 
to alter the 6510’s stack pointer in machine language routines. 
Sometimes, however, stack pointer manipulation is the most expedient 
way to assure that subroutines with multiple exit points stay in control. 
If your routines must alter the stack pointer, then you must preserve 
the return pointer residing on the stack when your routine first gets 
control. The Lt. Kemal DOS does a ‘JSR’ to any routine directly in¬ 
voked, and expects the return address to be on the stack at the ap¬ 
propriate place when your routine does its final ‘RTS’ back to system 
control. 


Reserved Memory Areas 

Although the ‘stack’ should not be altered without observing the 
previously mentioned constraints, no other single byte of RAM is ever 
required or modifed by the Lt. Kemal DOS (without replacing its EX¬ 
ACT contents). 
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Speed Tips 

The Lt. Kemal is faster than any other Commodore-compatible drive 
because of its rapid parallel transfer scheme. However, the ‘KERNAL’ 
operating system which Commodore provided with the computer does 
introduce substantial overhead which slows access to data that is read 
from files (even if you use the Lt. Kemal enhanced INPUT# command 
instead of GET#). The same holds true for machine language routines 
that use BASIN (Commodore’s GET character routine) or BSOUT to 
write data to files. There is a TREMENDOUSLY FASTER method 
you may use in NEW applications. 

Since the Lt. Kemal can access data files so rapidly, it is in the best 
interest of speed that you save DATA as PRoGram files rather than as 
SEQuential or RELative files. By LOADing or SAVEing data, you 
may realize the full increase in speed that the Lt. Kemal offers over 
the 1541 Commodore disk drive. 

Even if you can’t save data as PRoGram type files, the Lt. Kemal 
DOS provides extremely fast access to records of data in RELative 
files, and you may create indexes to individual records within 
RELative files using the KEY file structure to further speed access. In 
every instance possible, the use of RELative files instead of SEQuen¬ 
tial files will ensure that your application runs as F A S T as possible. 
The Lt. Kemal is faster than ANY other Commodore compatible disk 
drive on the market today. Make best use of its speed in your new 
programs. 


Disk Partitioning 

As you receive your new Lt. Kemal system, the disk will be set up 
with only two logical drives (LU 0 and LU 10). The Lt. Kemal DOS 
ALWAYS resides on LU 10. The rest of the possible eleven logical 
drives (LU 1 - LU 9) will not be configured. 

When you require more space and more logical drives for your ap¬ 
plications, we suggest that you initially CONFIGure die rest of the 
hard disk into equal sized partitions until you get a good feel for the 
space required by your applications. 

You may subdivide the space beyond logical unit 10 (which always re¬ 
mains fixed in size) into as many as ten logical drives, or as few as 
one logical drive. The CONFIG processor is the method by which you 
may accomplish this. Study the CONFIG section of this manual 
carefully and make sure you understand it all before you attempt your 
first CONFIG. Be sure to RECORD AND SAVE your logical unit 
parameters on paper: You’ll need those parameters in order to 
preserve files on logical units 0-9 if you ever do a SYSGEN to 
upgrade to a newer DOS. 




The use of KEY files 

This is one of the most complex subjects dealt with in this manual. 

You do not have to be an expert computer programmer to use the Lt. 
Kemal KEY files system: If you aren’t an expert, though, you are go¬ 
ing to need to absorb a lot of new information in order to make full 
use of this wonderfully powerful feature of the Lt. Kemal DOS. 

We will supply you with examples of KEY file use, but it would re¬ 
quire another manual the size of this one to explore all the possible 
uses for KEY files. If you wish to use KEY files on the Lt. Kemal to 
their fullest potential, study one of the several fine DATABASE 
MANAGER software packages available for Commodore computers, 
then return to this section. 

The KEY file system on the Lt. Kemal makes available from BASIC a 
complete KEYED INDEXED-RANDOM ACCESS METHOD for ac¬ 
cessing data. 

YOU WILL BE ABLE TO BUILD VERY COMPACT AND EX¬ 
TREMELY POWERFUL CUSTOM DATABASE MANAGEMENT 
PROGRAMS in BASIC using this file access system. 

The Lt. Kemal KEY file system consists of two utility commands and 
one system call (SYS) with six modes of operation which can be used 
to very rapidly search for and find specific data based on varied and 
complex search criteria. 

Originally the KEY file system was written for use in conjunction with 
RELative files. Its use is not restricted, though. You can use KEY 
files in any application where you need to associate TEXT STRINGS 
with specific numeric values. 

In the very simplest of terms, the KEY file system allows you to supp¬ 
ly a text string and associate a numeric value directly with that string. 
When you later SEARCH for that string in the file, the SEARCH 
command will return to you the value you previously associated with 
the string. 

That may sound very simple, indeed, but the applications to which that 
can be put are amazing. Additionally, the Lt. Kemal KEY file opera¬ 
tions are VERY fast. Some remarkable database management programs 
can be written in just a few lines of BASIC, and they operate at nearly 
the speed of machine language programs. 

Let’s define a few terms, then go on to actual uses of KEY files. 

KEY - is a literal string or string variable containing from one to thir¬ 
ty characters. The KEY is the basic ‘element’ of KEY files. Keys are 
the strings for which you will SEARCH in your applications. Depen- 
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ding upon the methods you use, a KEY may end up being used to 
refer to specific data, or may be used to point to yet another list of 
KEYS. 

DIRECTORY - When used in the context of KEY files, a directory is 
a list of UNIQUE keys within a KEY file. A KEY file may contain up 
to five DIRECTORIES of keys. Keys within a single directory must be 
UNIQUE. 

Record Number - is the NUMERIC value in the range 0-65535 
directly associated with each KEY within a DIRECTORY. This is the 
number returned to you when a SEARCH for a particular KEY is suc¬ 
cessful. It is supplied BY you when INSERTing a new KEY in a 
DIRECTORY, or when DELETEing a KEY. 

Reel and Rech - are the low-byte and high-byte representation of the 
Record Number. 

Rech = INT(Record Number / 256) 

Reel = Record Number-(Rech * 256) 

INSERT - means to place a new, unique KEY in a DIRECTORY. 

DELETE - means to remove a KEY from a DIRECTORY. 

SEARCH - means to attempt to find a particular KEY within a 
DIRECTORY. 

lfn - refers to the logical file number of a KEY file already OPENed 
on the hard disk. 

Status - is a single precision value returned as a result of the various 
KEY file commands and which reflects the success or failure of the 
command. 


For really advanced programmers, only: 

The structure of a KEY file is a B-tree with unidirectional links between 
each of three search levels: coarse, medium, and fine. The coarse and 
medium levels are NOT accessible via the KEY commands: only the 
results of the operation after passing to the fine level are passed back 
to your application. You can, however, create your own coarse-to-fine 
levels of search by utilizing multiple DIRECTORIES within KEY files. 


A KEY file example 

First, let’s set up a purely literal example of how KEY files work. 
After that, we’ll attack the actual commands, and give programming 
examples. If you are an advanced programmer, and are already 
familiar with keyed indexed-random file structures, you can skip this 
section, and refer to the programming examples now. 

We’ll use a simple catalog/cross-reference as an example. 
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Assume you have just three items to catalog: a camera, a dishwasher, 
and your pet dog. 

First, in order to catalog these items, you need to decide what features 
about them are important enough that you can remember to refer to 
them by those characteristics in the future. Here’s a list of unique 
features you decide to use, and the KEYS you wish to create to 
describe those features. 


item 

characteristic 

key 

camera 

Uses film 

film 


takes pictures 

picture 


very small 

small 

dishwasher 

holds dishes 

dish 


washes them 

wash 


very large 

large 

dog 

eats 

eat 


makes a mess of the yard 

mess 


medium size 

medium 

The ‘keys’ we decided upon above are all single words, because 
they’re easy to remember. They don’t have to be, though. The whole 
statment “makes a mess of the yard” could be treated as a KEY also: 
any text string up to 30 characters long can be a KEY. 

Look at the keys above. The longest is seven (7) characters in length. 
That becomes the ‘key length’, since all KEYs in a DIRECTORY 

must be the same length. 


So what do we do with the keys which are shorter than seven 
characters? We ‘pad’ them with some known character that makes 
them all seven characters long. As an example, let’s use spaces (noted 

by the ‘ 

character) to pad our keys. Padded, our keys look like 

this: 



item 

characteristic 

key 

camera 

Uses film 

film 1 ’ 


takes pictures 

picture 


very small 

small’ ’ 

dishwasher 

holds dishes 

dish* ’ 


washes them 

wash* ’ 


very large 

large* ’ 

dog 

eats 

eat* 


makes a mess of the yard 

mess* ’ 


medium size 

medium* ’ 
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Now, we’ll leave it up to your imagination to create a lengthy and 
VERY complete description of each item above (no cheating, now; 
describe the camera down to the last screw!), and save your descrip¬ 
tions in three boxes (disk files). Place the description of the camera in 
BOX #1, the dishwasher description in BOX #2, and a loving descrip¬ 
tion of your pet (including the cost of sod replacement last year) in 
BOX #3. 

We’re ready now to create a KEY file. We do it here with another 
box: a box labeled ITEMKEYS. We will INSERT keys into that box. 
We’ll need nine slips of paper to handle the nine ‘keys’ we defined 
above. 

On the left of each slip write the KEY (including any spaces padding 
it to 7 characters), and on the right of the slip note the RECORD 
NUMBER (the number of the item) to which the KEY applies (i.e. 
eats applies to item #3, the dog). As soon as you complete the first 
slip, drop it into the box. You’ve just INSERTed your first key. 

One of the intentional constraints imposed on you when using KEY 
files is that no two identical KEYS may be present in the same 
DIRECTORY: every key must be unique. From now on, we’re going 
to have to carefully check every KEY already in the ITEMKEYS box, 
to make sure we don’t duplicate one, before we may INSERT another. 

So write the next KEY slip, take ALL the slips already in the box out, 
check them to make sure none EXACTLY MATCH the one you’re 
about to INSERT, and if the new key is unique, drop it and all the 
other older slips back into the box. Repeat that boring cycle until all 
nine keys are INSERTED. 

Sound like a chore? It is, but in the Lt. Kemal KEY file system, that 
check is made for you, instantaneously, every time you attempt to IN¬ 
SERT a key in a KEY file directory. 

Now that you’ve built a KEY file FORGET EVERYTHING YOU 
EVER KNEW ABOUT DOGS, DISHWASHERS, and CAMERAS. 
Remember only this — 

You know you’ve got three boxes describing things, and one box with 
characteristics of things in it. Besides, you’re not so forgetful that you 
don’t remember what a mess, or a picture, or a picture of a mess is. 

Hmmm... ‘picture’ - a seven letter word. Let’s look in the 
characteristics box and see if there are any words spelled EXACTLY 
like that (exact-match SEARCH). Yep, and it says to look in box #1. 

Now you have recovered your memory about cameras! So let’s try 
‘mess’, a four letter word (indeed). Nope? No, but there was one 
close: only it was seven characters long, padded with spaces. But 
‘mess’ and ‘mess ’ MEAN the same thing, don’t they? Sure, so 
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let’s find the first KEY in that box higher alphabetically than ‘MESS’ 
and see where it takes us (greater-than SEARCH). 

Well, we came up with ‘mess ’, and it pointed to box #3. By gosh, 
now that your memory returns about your pet, you remember the 
yard! 

Now you’re getting the feel of it. All the characteristics in that box 
are seven letters long. You remember the word ‘dishes’ and remember 
to pad it out to seven characters, then go searching for it. No ‘dishes’ 
slip is in there (exact-match failed). You do a ‘greater-than’ search, 
and come up with ‘eat ’. Hey! that sounds good - but when you 
look in the box it points to, you get the dog, again. 

Next you look for the first slip LOWER alphabetically than 
‘dishes ’(less than search), and this time you come up with 
‘dish ’, pointing to box #2. That box describes the dishwasher, and 
you’ve completely recovered your memory. 

That’s a pretty simple example, sure, but imagine it with hundreds of 
items each with THOUSANDS of characteristics describing them. It 
would take quite a while to search all those boxes, wouldn’t it? 

That’s where the KEY file comes in. It takes only a fraction of a se¬ 
cond to search through any list of keys (DIRECTORY) using the Lt. 
Kemal KEY commands. You can single out a box (data record pointed 
to by a RECORD NUMBER) almost instantaneously, no matter how 
many keys you have to search. 

Already, you’re probably seeing potential applications for this techni¬ 
que — 

You could build a list of all your friends and business acquaintances, 
and by building several DIRECTORIES of KEYS (a single KEY file 
will hold five DIRECTORIES), you could cross-reference them by 
hobby, birth month, city, state, and marital status— 

and that is an almost trivial example! 

Enough with rudiments. We know you want to get on to using KEY 
files, so some rules for use and the command descriptions follow. 

As we said before, there are two utility programs, and one SYS with 
six modes comprising the KEY files commands. The utilities are 
Direct-Mode commands, the SYS’s are designed to be used primarily 
in the Run-Mode. 

BUILDINDEX is the command which allows you to create a new 
KEY file, and establish the KEY characteristics for it. BUILDINDEX 
is self-documenting. There are just a few constraints to creating a 
KEY file. 
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• A KEY must be no longer than thirty characters long: All keys 
within a single DIRECTORY are built to the same length. 

• The file may contain no more than five (5) DIRECTORIES of 
KEYS. 

• ALL DIRECTORIES within a given KEY file will contain the same 
number of KEYS (max. 65535). 

This needs explaining. Other than the fact that up to five KEY 
DIRECTORIES may exist within a single KEY file, there is no 
FUNCTIONAL relationship among them. They may contain KEYS 
which are entirely unrelated. 

However, because of the way in which KEY files are built, all 
DIRECTORIES within a single KEY file will be built for the SAME 
NUMBER OF KEYS ... That’s important, because the longest 
DIRECTORY you can create within a key file is directly dependent on 
the length of the LONGEST KEY defined for that file. 

A brief example will suffice to illustrate. If you built a KEY file with 
FIVE DIRECTORIES, each with KEYS 13 characters long, you could 
request a ‘number of keys’ as large as 65535. That’s the maximum 
number of KEYS you are ever allowed to build in any DIRECTORY. 

At a key length of 14 characters, the {lumber of KEYS PER DIREC¬ 
TORY begins to diminish. If you defined the key length as thirty (30) 
characters, you could have no DIRECTORY longer than 6750 KEYS. 

Now here’s the rub. If four of the five defined DIRECTORIES within 
a KEY file had key lengths of only 13 characters (allowing 65535 
keys/directory), but the fifth had a key length of thirty, then the max¬ 
imum number of KEYS PER DIRECTORY will still be diminished to 
6750 for ALL DIRECTORIES within that one file. That doesn’t mean 
that any space is wasted in the file. It’s just a functional limitation of 
BUILDINDEX. 

Here’s a table of maximum DIRECTORY lengths for different lengths 
of KEYS. 


KEY 

Max KEYS 

KEY 

Max KEYS 

length 

DIRECTORY 

length 

DIRECTORY 

1-13 

65535 

22 

18522 

14 

59582 

23 

16000 

15 

48778 

24 

13718 

16 

43904 

25 

11664 

17 

35152 

26 

11664 

18 

31250 

27 

9826 

19 

27648 

28 

8192 

20 

24334 

29 

8192 

21 

21296 

30 

6750 
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The table is computed from the formula — 

Nkeys = (INT( 507 / (L+))t3 ) * 2 

where L is the length in characters of the longest key, and 
Nkeys(max) = 65535. 

Another constraint on KEY files. 

• Because of the manner in which KEYS are INSERTed in a B-tree, a 
DIRECTORY should be constructed for about 20% MORE KEYS 
than you expect to use. 

This will GREATLY affect the speed of insertions when you have 
many similar KEYS in a single DIRECTORY. Be conservative in 
your estimates of needed keys: Twenty megabytes will hold a lot of 
data. 

The last limitation of KEY files — 

• The space required to build a KEY file must be available in 
CONTIGUOUS blocks on the LU on which it is to be built. 

If there is enough space, but not sufficient CONTIGUOUS space 
available on an LU for the KEY files you wish to build, the 
method to get it all contiguous is: 

AUTOCOPY all files to another LU. 

ACTIVATE the LU you wish to clean up. 

AUTOCOPY all the files back. 

This performs a quick equivalent of the 1541 VALIDATE command. 

Now a brief discussion of the other utility for KEY files. DI, then on 
to the Run-mode commands. 

DI (dump index) is provided as a convenience to KEY-file program¬ 
mers. The same function could be written in BASIC, as we will show 
later. 

DI simply lists all active keys in a KEY file. DI will prompt you for 
the name of the KEY file you wish to dump. 


Key-File Run-Mode Commands 

The general form of the KEY commands is: 

SYS 64628:mode,lfh,directory ,Stringvar,recl,rech,status 

The parameters list may consist of variables or literal values, or a 
mixture of both. The colon following the SYS address is required in 
order to maintain C-64/C-128 compatibility. 
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The mode parameter defines what KEY command will be performed. 
The modes are: 


mode function 

0 not used — 

1 INSERT key 

2 DELETE key 

3 exact-match SEARCH for key 

4 greater-than SEARCH for key 

5 less-than SEARCH for key 

6 not used 

7 SHUFFLE directory 


general: SYS 64628:mode,lfh,directory .Stringvar,reel,rech,status 
The other parameters are, again: 

Ifh - refers to the logical file number of a KEY file already OPENed 
on the hard disk. 


directory - The number (1-5) of the directory within the file which 
you wish to access. 

Stringvar - A literal or variable string containing the KEY with which 
you wish to operate. For SEARCH functions, this key should be padd¬ 
ed to the KEY-LENGTH of the directory chosen (usually with spaces 
or nulls). INSERT will pad the KEY with nulls if you supply a 
Stringvar shorter than the KEY length for that directory. 

Reel and Rech - are the low-byte and high-byte representation of the 
Record Number. 

Rech = INT(Record Number / 256) 

Reel = Record Number-(Rech * 256) 

The Record Number is the NUMERIC value in the range 0-65535 
directly associated with each KEY within a DIRECTORY. This is the 
number returned to you when a SEARCH for a particular KEY is suc¬ 
cessful. It is supplied BY you when INSERTing a new KEY in a 
DIRECTORY, or when DELETEing a KEY. 

Status - is a single precision value returned as a result of the various 
KEY file commands and which reflects the success or failure of the 
command. 
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The status variable may change in meaning, depending upon which 
KEY command you are using. See each command below for specific 
status returns. The general definitions of the status values are: 

status meaning 

0 command was successful 

(meaning of ‘success’ varies with 
each command) 

1 invalid directory # 

2 variable by command 

3 DIRECTORY Links corrupted: 

!!!FATAL SYSTEM ERROR!!!! 

4 variable by command 

5 variable by command 

6 file not open, or file opened 
is not a KEY file 

Status value 3 should never be encountered. The only time links might 
be corrupted is when the computer is turned off (power failure) during 
an INSERT or DELETE operation. If a status of 3 is EVER returned, 
abort the application, and attempt to recover as many KEYS from the 
file as possible into a new KEY file. After recovery, ERAse the cor¬ 
rupted file. 

In the command descriptions which follow, the GENERAL status 
returns always apply. Only the variable statuses will be discussed with 
each command. 

The INSERT key command - mode=l 

SYS 64628:1 ,lfn,directory,Stringvar,reel,rech,status 

This command inserts a new, unique key into the selected directory. In 
addition to the lfn # and directory #, you must supply: 

The EXACT key to insert (length = key-len) 

The record number in reel and rech to be associated with the KEY. 

The variable status returns from INSERT are: 

0 INSERT successful 

2 invalid key length (key supplied is 

longer than key length for 
directory) 

4 DIRECTORY full - insert cannot 
occur 

5 KEY already exists, cannot 
duplicate keys 
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If directory full status (4) occurs, a SHUFFLE may fix the condition: 
more on that later. 

If status 5 (key exists) is returned, you must either change the key you 
supply, or DELETE the key from the directory, then re-insert it. 

The DELETE key command -mode=2 

SYS 64628:2,lfn,directory,Stringvar,reel,rech,status 

This command attempts to delete a key from the selected directory. In 
addition to the lfn # and directory #, you must supply: 

The EXACT key to delete (length = key-len) 

The EXACT record-number in reel and rech already associated 
with the KEY. 

The variable status returns from DELETE are: 

0 DELETE successful 

2 invalid key length (key supplied is 

longer than key length for 
directory) 

5 KEY not found, or record number 

supplied does not match record 
number already associated with 
KEY found. 

The SHUFFLE directory command - mode=7 

SYS 64628:7,lfn,directory,Stringvar,reel,rech,status 

Because of the manner in which B-tree key insertions occur, 
sometimes there will not appear to be an available slot for a new key, 
even when sufficient space exists in a directory. SHUFFLE attempts to 
re-order the KEYS in an existing directory to make slots available. 

If an attempt to INSERT a key returns a status of 4 (directory full), 
you should SHUFFLE the directory, and attempt the INSERT again. 

If, after TWO ATTEMPTS to SHUFFLE and INSERT, the directory 
full status is still returned, you may actually consider the directory to 
be full. 

You must supply: 

The logical file number of the KEY file already OPEN. 

The directory number of the directory you wish to SHUFFLE. 

There are only two variable status returns from SHUFFLE: 

0 SHUFFLE completed (NOT an in¬ 

dication that slots were freed up) 

2 No keys in directory (SHUFFLE 

not done) 



The SEARCH commands 

The SEARCH key command - mode=3, 4, or 5 

exact-match SYS 64628:3,lfh,directory,Stringvar,reel,rech,status 
greater-than SYS 64628:4,lfh,directory,Stringvar,reel,rech,status 
less-than SYS 64628:5,lfh,directory,Stringvar,reel,rech,status 

The SEARCH commands allow you to very rapidly search a directory 
for a particular key, based on variable criteria. 

In addition to the logical file and directory numbers, you must supply: 

The SEARCH mode 
and 

The KEY for which to search (length < =key-len) 
for exact-match, length = key-len 

The variable status returns from SEARCH are: 

0 KEY satisfying criteria found 

2 invalid key length (key supplied is 

longer than key length for 
directory) 

5 KEY satisfying search criteria 

NOT found 

SEARCH ALWAYS RETURNS THE KEY FOUND WHICH 
SATISFIES THE SEARCH CRITERIA IN Stringvar, and the record 
number associated with that key in reel and rech. 

If no satisfactory key is found, Stringvar is unmodified, and reel and 
rech are meaningless. 

An exact match is satisfied when the KEY (including pad characters) 
exactly matches the Stringvar in length, and character-by-character. 

A greater-than match is satisfied when the first KEY logically greater 
than the supplied Stringvar is found. 

A less-than match is satisfied when the first KEY which is logically 
less than the Stringvar supplied is found. 

As an example of how to use KEY files on the Lt. Kemal, we’re go¬ 
ing to build a dictionary application in BASIC. The dictionary will 
hold up to 6750 words of up to 30 characters in length. 

Each word will have a text definition keyed to it. The dictionary will 
permit us to have a total of 65535 lines of 40 characters assigned to 
definitions of words. Any single word may use up to 20 forty - 
character lines for its definition. 
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When searching for a word in the dictionary, if the word is not found, 
the dictionary will display the words alphabetically surrounding it, and 
give you an opportunity to display the definition of one of them, or to 
enter the new word into the dictionary. 

If all that sounds like it will take a pretty large, slow BASIC program 
to accomplish, you’re in for a pleasant surprise! Not only does it take 
only 39 lines of program to build such a dictionary, but it takes less 
than one second to find any word already in it, or to determine that 
the word is not there! 

Because of the length of the example, the actual program appears in 
APPENDIX i. 


The CONFIG processor 

CONFIG is a powerful (and potentially dangerous!) utility program 
which allows you to set many system defaults. You may change 
several power-on characteristics of the system including screen, 
border, and character colors, the hard disk device number, the logical 
unit (logical drive) and user (subdirectory) onto which the system first 
‘logs’ or establishes operation, and the sizes of the various logical 
drives which the system may emulate. 

For the most part, CONFIG is self-documenting, and will prompt you 
through the changes it can accomplish. Once you exit CONFIG pro¬ 
perly, any characteristics of the system you have set will remain that 
way EVERY TIME you turn on the power to your system. 

Only a few points of CONFIG need explaining. The first is the ‘beep 
flag’. When the beep flag is set to 1 (one) the beeper is enabled. After 
that, any time you issue a CHR$(7) through a BASIC print statement 
or a byte of value 7 through the KERNAL’s BSOUT routine, the Lt. 
Kemal will issue an audible ‘beep’ through the monitor’s speaker. This 
feature is provided simply as a convenience to programmers so that 
you do not have to maintain SID drivers in your C-64 programs just to 
issue audible prompts. 

When the beep flag is set to 0, CHR$(7) has no effect in the C-64 
mode (the C-128 does its own beeps). This character is NOT reserved 
in the Commodore-64 character set for any special purpose and is not 
a printable character. Usually, it is desirable to keep the beep flag 
enabled because all Lt. Kemal DOS error messages use the beep, 
when enabled, to alert you that an error has occurred. 

The second point of CONFIG explanation concerns the default logical 
unit number. This point is only critical inasmuch as it affects the 
AUTOSTART feature of the Lt. Kemal DOS. 
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When the Lt. Kemal first powers up, or after a hardware reset, it 
FIRST switches to the logical drive defined in CONFIG and THEN 
searches for a file by the name of AUTOSTART. If you wish to use 
the AUTOSTART feature of the Lt. Kemal, make sure that the pro¬ 
gram you have named ‘AUTOSTART’ resides on the same logical 
drive that you have named as the default in CONFIG. 

The third point concerns the hard drive’s default hardware device 
number. The only special situation here is when the hard disk and a 
floppy drive BOTH carry the same device number. 

This is a special and very desirable situation, contrary to first ap¬ 
pearances. In this situation, any COMMODORE-SYNTAX LOAD re¬ 
quest directed to the system either through BASIC or the KERNAL 
vectors will be directed first to the hard disk. If the file requested is 
not found on the hard disk, the request will be AUTOMATICALLY 
referred to the floppy disk (neat, huh?). Requests to load a file via the 
Lt. Kemal’s abbreviated ‘L’ load command, or by direct invocation 
will not be referred to the floppy disk. The automatic referral of 
LOAD commands only applies when both the hard disk and the floppy 
disk carry the SAME hardware device number (usually 8). 

If this ‘AUTOACCESS’ feature interferes with a particular application, 
you may turn it off via CONFIG. 

The last point of CONFIG to discuss is the most complex, and to a 
degree, somewhat hazardous. The point at issue is the CONFIGuration 
of logical unit (logical drive) parameters. 

Briefly, let’s discuss how the Lt. Kemal (and most hard disk systems) 
allocate space on the disk. 

In a floppy disk environment, space on a diskette is usually parcelled 
out in units known as SECTORS or BLOCKS. A sector is the smallest 
unit of data which a floppy disk may read or write at one time. 

A hard disk also may read or write as little as one SECTOR of data at 
one time: Hard disks, however, have HUGE numbers of sectors 
available. In order to make those numbers more managable, most hard 
disk systems allow you to allocate (set aside for future use) sectors in 
groups. The largest number of sectors which may be accessed on a 
hard disk without requiring any mechanical repositioning of the ‘heads’ 
(the part which physically reads and writes data) is known as a 
CYLINDER. 

Thus, the CYLINDER becomes the smallest unit of storage which may 
be allocated on the Lt. Kemal. Remember that allocating space doesn’t 
use it up; It only sets that space aside for use later. When programs or 
files use that space, they use it on a sector-by-sector basis. 
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On the Lt. Kemal system, a CYLINDER contains 68 SECTORS, each 
of which is twice the size of a 1541 sector (or block). The Lt. Kemal 
stores data in 512-byte sectors, and the 1541 in 256-byte sectors. Since 
a cylinder contains sixty-eight sectors, that is the minimum increment 
of space you may allocate to a logical drive (LU). 

The Lt. Kemal DOS resides on LU 10, and that logical drive is 
always fixed in size at 30 cylinders; You may not change its size. All 
other LU’s (0-9) sizes are user-definable via CONFIG. 

An LU or logical drive must contain at least enough space for the 
‘BAM’ and ‘INDEX’ which constitute the directory storage area for 
that LU. Since any Lt. Kemal LU may hold up to 4000 directory en¬ 
tries, the MINIMUM amount of space you must allocate for a new LU 
is 16 cylinders, or 1088 hard disk blocks. After the creation of the 
BAM and INDEX, which collectively use 272 blocks, that leaves 816 
blocks available on the LU for your files. That works out to about as 
much space as 2-Vi full 1541 diskettes. 

That’s the minimum space you may allocate to a new logical drive. 

You can allocate more space in CYLINDER increments, up to a max¬ 
imum 911 cylinders. Since that’s more than the number of cylinders 
available on a 20 megabyte drive, there is no practical limitation to the 
size of a single LU, other than the remaining un-allocated capacity of 
your drive. 

CONFIG will not allow you to allocate less than 16 cylinders to a new 
LU, nor will it permit you to allocate more space than that which is 
available. Those restrictions are automatic - you don’t need to do any 
math to use CONFIG. 

When CONFIG is caused to enter the SET LU PARAMETERS mode, 
it will respond with the CURRENT logical unit boundaries in table 
form. You will be given the current total cylinders available on the 
hard disk, along with the current cylinder boundaries of any already 
defined logical units. CONFIG will allow you to establish new 
cylinder boundaries for any logical unit with the following 
constraints— 

No logical unit may ever overlap an existing logical unit. CONFIG 
will prevent you from declaring any LU boundary which overlaps an 
existing LU boundary. If you wish to expand a logical unit to a point 
which will overlap an existing logical unit, you must first shrink the 
conflicting LU in the appropriate direction. To shrink an LU, you 
must first delete the LU’s entry, then re-declare its boundaries. 

IF YOU MOVE THE LOWER BOUNDARY OF AN ALREADY 
USED LU, ALL FILES ON THE LU WILL BE LOST. If you shrink 
an LU by moving its upper boundary, SOME files may be lost, depen¬ 
ding on how full (and how old) the LU is, and a NEW LU created 
just above it may also be endangered. 
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The only safe way to re-defme an LU’s size is to AUTOCOPY all of 
its files to another LU, redefine its size, ACTIVATE the LU, then 
AUTOCOPY the files back. 

The total cylinders ascribed to all logical units defined in CONFIG 
may not exceed the total cylinders available on the hard disk. CON¬ 
FIG will prohibit this. 

Now the one point of danger. CONFIG REQUIRES that YOU record 
the logical unit parameters you have established. You may direct your 
LU parameters to the printer or the screen, but once you have selected 
a destination for the parameters, you MUST record and save them for 
future reference. The reason is simply — 

If you ever do a SYSGEN (which builds a new DOS), the diskette we 
supply you for SYSGENing the DOS cannot know the logical drive 
boundaries you have arbitrarily selected. After a SYSGEN you must 
IMMEDIATELY run CONFIG again and re-enter the EXACT logical 
unit parameters in effect before you did the SYSGEN. 

If you enter those parameters properly, none of the data or programs 
on logical units 0-9 will be affected. If you fail to properly enter the 
parameters via CONFIG, all of your data may be rendered 
inaccessible. 

RECORD AND SAVE your LU parameters list every time you change 
LU parameters — 

THIS IS YOUR RESPONSIBILITY!!! 

When you establish a NEW LU via CONFIG, you will be given the 
option to create a ‘DOS image file’. The DOS image file is an op¬ 
tional feature of the Lt. Kemal which tremendously enhances the speed 
of file access on LU’s physically distant from the DOS LU. 

When the DOS is running, it must continually refer back to the DOS 
LU to bring in DOS overlays (the term we use to describe the various 
program modules of the DOS). Every time an overlay is required, the 
disk drive must physically reposition its ‘heads’ from the LU you are 
using to the DOS LU (lu 10), and then back again. 

The further (in cylinders) your working LU is from the DOS, the 
longer that process takes. In order to speed it up, we offer you the 
ability to build a COPY of the run time modules of the DOS on each 
LU you create. The pay off is a dramatic increase in speed of Lt. Ker- 
nal file access. The cost is space. 

A DOS image file uses 222 hard disk blocks. In most instances, you 
won’t even miss this small (?!) amount of space. If your system is full 
right up to the gills, though, you may opt not to create DOS image 
files. 
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Once you have defined a new LU or changed the size of an old one, 
and exited CONFIG, you must run ACTIVATE which always totally 
erases all files except DOS image files, and creates a new BAM and 
INDEX on the LU. It is not safe to use an LU which has not been 
ACTIVATEd, since an old BAM and INDEX may still exist which do 
not properly reflect the new physical size of the LU. THIS COULD 
EVEN ENDANGER AN LU PHYSICALLY ADJACENT TO THE 
‘BAD’ LU. The only exception to this is when the EXACT original 
parameters of an LU are re-established after a SYSGEN, as discussed 
below. 

One final note about CONFIG concerning doing a SYSGEN. The 
logical unit boundaries of LU’s 0-9 can be re-established by you via 
CONFIG after a SYSGEN is run; The files on those LUs will remain 
intact. Logical unit 10 ALWAYS remains fixed in size, and is 
ALWAYS completely overwritten by a SYSGEN. 

We do not prohibit your using logical unit 10. In fact, the utility pro¬ 
grams you wish to be accessible from ALL other logical units should 
be placed on LU 10. Remember, however, that LU 10 is COM¬ 
PLETELY ERASED AND REPLACED during a SYSGEN. Any pro¬ 
grams you wish to preserve on LU 10 should be copied to another LU 
or to floppy disk before you do the SYSGEN. 

THE SYSGEN UTILITY 

SYSGEN is contained only on distribution diskette(s) supplied with the 
Lt. Kemal DOS upgrades. To receive the Sysgen disk, you must fill 
out the FISCAL INFORMATION registration card and mail to Fiscal 
Information, Inc. 

SYSGEN creates a new DOS on the hard disk. It completely replaces 
the area reserved for LU 10 with a NEW LU 10 which contains the 
DOS supplied on the distribution diskette(s). 

The distribution diskette(s) you receive with your Lt. Kernal DOS up¬ 
date are produced on OUR floppy disk drives. That’s important 
because your floppy disk drive may not be in exactly the same align¬ 
ment, or run at exactly the same speed as ours. That’s why we en¬ 
courage you (read this as INSIST) to copy all the surfaces of your 
distribution diskette(s) to your OWN diskettes before attempting a 
SYSGEN. 

Our distribution diskettes are not copy protected. You purchased them; 
you have the right to copy them as many times as necessary to protect 
their contents. They do not contain programs as such, however, so you 
MUST use some sort of ‘image’ copier like ‘DISECTOR’ or ‘THE 
CLONE MACHINE’ to copy them. Be sure to copy the WHOLE of 
each surface, NOT JUST ‘ACTIVE’ SECTORS. 
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Most image-copy routines like those mentioned report any errors en¬ 
countered during the copy process. If you encounter ANY errors while 
copying a Lt. Kemal DOS diskette, there has been a problem and you 
should attempt the copy again. WE PLACED NO ERRORS on your 
diskettes intentionally. As you copy the surfaces of the Lt. Kemal 
SYSGEN diskette(s), label each new copy consecutively as ‘A’, ‘B\ 
‘C\ etc. 

When SYSGEN is run, it will ask for the insertion of diskettes ‘A’, 
‘B’, ‘C\ and so on, as necessary. Keep your labels straight, and make 
sure that the copies are made on the disk drive you intend to use for 
SYSGENing a new system. 

Doing the actual SYSGEN is simple. Place the ‘A’ diskette in your 
floppy drive and press the SPACE bar then type: 

LOAD “*”,8,1 

Soon a menu will appear with your own personal information includ¬ 
ed. You will be given several opportunities to abort the procedure 
before it actually begins. Once SYSGEN starts, you must not attempt 
to interrupt the process. 

SYSGEN is simple. Just follow the prompts and insert each new disk 
(‘A’, ‘B\ ‘C’, etc.) as requested. When SYSGEN has completed, do a 
complete power-down and reset of your system before attempting any 
other functions. Before doing ANYTHING else, immediately enter 
CONFIG and re-establish your LU parameters and power-up defaults. 
After exiting CONFIG, run UPDATEDOS to cause all DOS image 
files on the active LUs to be replaced with versions which reflect the 
new DOS. 

Failing to run UPDATEDOS will not endanger your system. However, 
the run time modules (DOS image files) you may have placed on 
various LUs will not be accessible to the DOS until you have done it. 
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ADDENDA/ERRATA 

and 

BUG FIXES AND PATCHES 

This section is reserved for addenda describing discovered software 
problems, the fixes, and DOS versions reflecting the fixes. Please in¬ 
sert addenda supplied with any DOS updates in this section. 
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XI 

TROUBLE-SHOOTING 


We hope you never have to trouble-shoot your Lt. Kemal hard disk 
system, but shipping, even in the best of containers, can be hard on 
mechanical devices. Your Lt. Kemal system was fully tested and 
burned-in at the factory before it was shipped. It should arrive in 
perfect working order. 


General Procedures 

Trouble shooting any system should follow a strictly ordered pro¬ 
cedure. Only after verifying that each prerequisite feature is in order 
should the next feature be checked. The following guide will step you 
from the most elemental causes of system failure through to some 
more complex possible causes. Usually the cause of failure WILL be 
one of the simpler ones. 

Regardless of how ridiculously simple an item might seem, check each 
item carefully and in the order indicated. Doing so will lead you to a 
quick resolution of the problem. You may fail to find the problem if 
you skip steps, or be led down a long and fruitless path making you 
retrace many previously checked points. 

TROUBLE-SHOOTING GUIDE 


I. CABLING 

A. DATA CABLE and ADAPTOR BOARD 

1. Check cable connection at Lt. Kemal Host Adaptor and hard 
disk enclosure 

a. Check for proper pin 1 alignment 

b. Check for full and even insertion 

2. Check Lt. Kemal Host Adaptor insertion into computer 

a. Check that Host Adaptor nose is properly aligned with 
expansion port slot inside computer 

b. Check that Host Adaptor is fully and evenly inserted 
into computer expansion slot 

c. Check for proper connections of jumpers, HIRAM and 
CAEC cables, and the C-128 cable. 

B. POWER CONNECTIONS 

1. Check cord entry to Lt. Kemal hard disk enclosure 

a. Check that power cord is fully inserted 

b. Check that power cord is plugged into a functional outlet 
for the correct voltage and frequency of power 

c. Check that hard disk power switch is ON at appropriate 
point in power-up sequence 
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II. FUNCTIONAL TESTS 

FIRST — Check your computer without the Lt. Kemal Host Adaptor 
plugged in. If it performs normally, then reinstall the Host Adaptor 
and proceed. 

A. SYMPTOM — SCREEN remains blank indefinitely, or remains 
blank for about 1 minute then the normal Commodore sign-on 
messages appear WITHOUT the Lt. Kemal messages. 

1. A blank screen is normal on the C-128 if the 2 mhz fast mode 
is selected in the C-64 mode. Remedy by returning to the 
1 mhz mode. 

1. Check the internal fan to see if the Lt. Kemal is running — 
IF NOT: 

a. Check that the Lt. Kemal power switch is ON 

b. Check that the POWER CORD is firmly seated in the 
receptacle on the rear of the Lt. Kemal hard disk 
enclosure 

c. Check that the POWER CORD is firmly seated in the 
outlet into which it is plugged 

d. Check with another device (such as a lamp) that the 
power outlet used for the Lt. Kemal IS ACTUALLY 
supplying power 

e. Check the Lt. Kemal’s fuse 

• remove the power cord from the Lt. Kemal’s 
power receptacle 

• gently unscrew the cap of the fuse holder until 
the cap and fuse together are removed 

• carefully pull the fuse and the cap apart 

• inspect the fuse. If necessary, check the fuse with 
a continuity checker. If it is blown, replace it 
ONLY with the exact original type. 

2. Check the ribbon cable 

a. Check for full, FIRM, and even insertion of the cable 
into its connections at both ends 

b. Check that pin 1 of the cable corresponds to pin 1 of 
the connectors on both the Host Adaptor and the drive 
enclosure 

c. Check that the cable has not been tom or frayed at any 
point especially CLOSE to its connectors 

d. ONLY IF THE POINTS ABOVE CHECKED OK, 
then remove the ribbon cable from its connections and 
check the pins inside each connector to see that no pins 
have been bent or broken by improper insertion of 
the cable 

— if any pins are bent, GENTLY staighten them 
with a small, flat tool like a cosmetic ‘orange 
stick’ or a very small screw driver 
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— if any pins are broken, you may have to return 
your Lt. Kemal to Xetec, Inc. for repair. Call 
our technical support for service. 

3. Check computer’s power supply 

a. Check the red POWER indicator on your computer. If 
it seems dim or is not on at all, suspect either a bad 
computer power supply, or a defective Lt. Kemal Host 
Adaptor 

b. Test you computer / Lt. Kemal combination with 
another known-good computer power supply (prefer- 
rably one of the NEWER ones) 

c. If the above checks do not resolve the problem, check 
your computer and power supply with any large car¬ 
tridge (i.e. Commodore’s CP/M cartridge) 

B. SYMPTOM — Your Lt. Kemal works properly for a time (seconds 
to hours), then begins to behave erratically, or screen colors begin 
to change for no apparent reason, or the system ceases to function 
entirely 

THIS IS THE MOST COMMONLY REPORTED PROBLEM 
WITH THE LT. KERNAL SYSTEM (and all systems which 
use large, active cartridge modules) 

The Lt. Kemal Host Adaptor has been designed very conser¬ 
vatively. It draws less than two-thirds the amount of power 
from the computer that Commodore specifies it may. Yet 
MANY power supplies do not meet even Commodore’s own 
specifications for supplying extra power to accessory devices. 

Try a different power supply. The newer ‘potted’ version 
seems a little better at supplying extra power than the original 
design. The IDEAL solution is to obtain one of the excellent 
third-party designed supplies which GUARANTEE to meet or 
exceed Commodore’s specifications. 

C. SYMPTOM — The Lt. Kemal does a ‘double boot’. The screen 
briefly displays the sign-on message at the top, then it shrinks 
horizontally and returns to a NORMAL sign-on screen WITHOUT 
the Lt. Kemal messages. 

Your DOS software resident on the hard disk HAS BEEN 
DAMAGED. The DOS loader has sensed the damage and 
turned itself and the Lt. Kemal Host Adaptor off. 

AT THIS TIME YOU HAVE ONLY ONE METHOD OF 
RECOVERY AVAILABLE. 
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YOU MUST PERFORM THE ‘SYSGEN* PROCESS. 
SYSGEN will not by itself destroy any of the software you 
have on logical drives 0—9, but will destroy all files on 
logical drive 10. 

DEPENDING ON WHAT CAUSED your DOS to be cor¬ 
rupted, you may also have to perform a FORMAT of the 
hard disk. FORMAT will always DESTROY ALL DATA 
you have stored on the hard disk. 

Turn to the section ‘THE SYSGEN UTILITY’ if your Lt. 
Kernal does a ‘double-boot’. 

D. SYMPTOM — The system displays the first couple of lines of 
sign-on messages, then just ‘hangs’ and never displays the 
‘READY’ prompt. 

Your DOS software has been corrupted, as previously 
described under ‘double-boot’symptoms. 

Turn to the section ‘THE SYSGEN UTILITY’ if your Lt. 
Kernal displays this symptom. 

E. Your hard disk begins to make a high-pitched whistle which con¬ 
tinues, but the system appears to behave normally otherwise. 

This is an annoying symptom which is present to some degree 
on almost every brand of small hard disk. We have chosen a 
brand which is not inclined to ‘squeal’, but still, it might 
happen. 

The whistle or squealing noise is caused by dust particles con¬ 
taminating one of the rotating parts of the hard disk. It will 
not interfere with normal use and the noise will usually sub¬ 
side within minutes (to hours) after it begins. Drives allowed 
to sit for several hours between uses are most apt to display 
this symptom. Drives in continuous duty (like BBS systems) 
almost never make this sound. 

F. SYMPTOM — Your hard disk enclosure gets very warm or hot 
to the touch. 

QUICKLY, SHUT THE SYSTEM DOWN!! Your Lt. Kernal 
is fan-cooled. Normally, the only warm area will be around 
the ventilation exhaust slots. If the top or sides of the hard 
disk enclosure begin to get warm, it’s a good indication that 
the ventilation slots in the enclosure have either been blocked, 
or that the fan has failed (possible due to dust accumulation). 

NEVER RUN THE LT. KERNAL WITHOUT 
THE FAN IN PROPER WORKING ORDER! 



RETURN POLICY 


Do not return any Lt. Kemal to Xetec without a RETURN 
MATERIAL AUTHORIZATION number (RMA#). If a RMA# is not 
clearly marked on the outside of the shipping carton, the product will 
be refiised. 

Call (913) 827-0685 to obtain a RMA#. 

Prepare the drive for shipment using the “SHIP” command described 
on page 8-35. 

Use the original carton or equivalent, insure shipment or assume 
the risk of loss or damage in transit, and pre-pay the shipping 
charges. 

Send a letter with the Lt. Kemal detailing the specific problem. This 
will speed up the return of your unit. 

If the unit is under warranty, include a copy of the proof of purchase. 
If this is not included, you will be billed for the repair. 

NOTE: The limited warranty will be honored only if the XETEC, Inc. 
registration card is completed and mailed to Xetec. 

REMEMBER, follow these steps: 

1. Obtain a RMA # 

2. Prepare drive for shipping using “SHIP” command 

3. Use the original carton or equivalent. 

4. Insure shipment. 

5. Pre-pay shipping charges. 

6. Include a letter describing the problem 

7. Include proof of purchase, if under warranty 
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XII 

DOS SYSTEM UPDATES and ENHANCEMENTS 


To qualify for DOS updates, you must have REGISTERED with FISCAL 
INFORMATION, Inc. by filling out the Fiscal registration card. You 
will then receive your Sysgen disk. 

Certain enhancements such as CP/M are to follow and will carry charges. 
Notices will be sent to registered owners only. 

The limited warranty will be honored only if the XETEC, Inc. registration 
card in completed and mailed to Xetec. 


‘BUG 6 REPORTING 

Unfortunately, every system of software will eventually be discovered 
to contain ‘bugs’ or errors in programming. We have made every ef¬ 
fort to ensure that the Lt. Kemal DOS is bug-free. If you do find a 
software defect, PLEASE REPORT THE PROBLEM AS SOON AS 
POSSIBLE to us on a copy of the form which follows. We truly wish 
to make the Lt. Kemal error free, and will give every formal ’bug’ 
report close and careful consideration. 

The bug reporting form appears separately on the next page so that 
you may photo copy it as necessary. 

PLEASE LIMIT your trouble reports to ONE problem per form. You 
may, however, send more than one bug report per envelope. 
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LT. KERNAL DOS REPORT FORM 


THANK YOU FOR YOUR ASSISTANCE IN IMPROVING 
THE LT. KERNAL! 

Please report only ONE problem per form, however, you may send 
more than one form per envelope. 

Please answer all questions, if possible. 

SERIAL NUMBER _ 

DOS VERSION/REVISON #_ 

Date of problem / / Approx, time of day _ 

C-64 or C-128 (circle one) & computer serial # _ 

Approx, how long have you owned your Lt. Kemal system?_ 

Does the problem occur under identical circumstances WITHOUT the 
Lt. Kemal Host Adaptor module plugged in? (circle) Y or N 

Approx, how long had the system been turned on before the problem 
was detected? _ 

Does the problem appear immediately with a cool system and power 
supply, or only after a period of warm up? 

(circle) COOL WARMED UP 

If you circled WARMED UP, how long must the system warm up 
before the problem FIRST begins to occur?_ 

Please describe the problem and all surrounding circumstances in as 
much detail a spossible. Include NAMES and VERSIONS if other 
commercial software/hardware products are involved. Use the back of 
this form if more space is required. 



APPENDIX I 

KEY File Programming Example 


The following program implements a complete ‘dictionary’ on the Lt. 
Kernal. This is NOT intended to be an example of good programming 
practice, or even to demonstrate the limits of the KEY file system, but 
rather to serve as a fairly good example of a (simple) KEY file 
application. 

Lines 1-89 aren’t even really part of the dictionary application. They 
comprise a BASIC full-screen editor to make your life a little easier 
when entering the word definitions into the dictionary’s ‘definitions’ 
file. 

Lines 91-249 actually demonstrate KEY files. The editor code is plac¬ 
ed at the beginning only to make it run faster. 

This is a very simple, single KEY system. The organization is: 

• One KEY file with one directory of 6750, 30 character ‘word’ 
keys. The record numbers associated with the keys point directly to 
a specific record in the definitions (RELative) file. 

• A definitions file. This RELative file is intially OPENed for a 
record length of 41 characters. Each screen line entered in a word’s 
definition occupies a single record, with the leading character of 
each record set to ‘ “ ’ (quotation mark) to allow puncuation to be 
INPUT from BASIC. 

The record number fetched from a SEARCH of the KEY file points to 
the FIRST record of definition. That record contains a single numeric 
value defining how many lines of text definition follows. 

That means, of course, that one record is ‘wasted’ for every definition 
in the file. In a two-tiered KEY system, the definitions’ lengths could 
be contained in yet another KEY file with keys of only 5 characters in 
length. Remember that KEYs may be ANY text, even print images of 
numeric values. With that in mind, the record number derived from 
the word search could BOTH point to the first line of definition in the 
RELative file, AND be used as a KEY to find the length of the defini¬ 
tion in another KEY file. The multi-tiered keying can be carried on in¬ 
finitely, for very complex search criteria. 

An organization diagram for a short, theoretical version of our dic¬ 
tionary follows: 
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The file ‘DICTKEYS’ contains the words. The file ‘DEFINITIONS’ 
contains the text of the definitions. Record #1 of that file also con¬ 
tains a pointer to the NEXT available record in itself. 


KEY FILE 
name ‘DICTKEYS’ 
org. 6750 kays (words) 
of 30 char. 

KEY REC-NUM 


RELative file 
‘DEFINITIONS’ 
up to 65535 lines 
of 41 char. 

RECORD DEFINITION 


APPLES 2 

FIGS 4 

MONEY 9 

ZEBRA 6 


1 11 (next avail, rec.) 

2 1 (length in lines) 

3 “RED fruit” 

4 1 

5 “YELLOW fruit” 

6 2 (2 lines of def.) 

7 “A horse-like,” 

8 “African animal.” 

9 1 

10 “coinage” 


In order to use the program which follows, you must first build the 
KEYs file. This needs to be done only once. 


Enter the command BUILDINDEX 
Supply the file name ‘DICTKEYS’ 
Request 6750 keys 
Request ONE directory, and 
a KEY length of 30. 


The program will automatically create and intialize ‘definitions’, the 
RELative file. You will supply the words and the definition text when 
the program is run. 


The program follows: 







I GOTO 173:REM SETUPS 

3 REM BASIC FULL-SCREEN EDITOR 
5 REM RETURNS UP TO 20 FULL LINES IN E$(1-20) 

7 REMEMBER TO DIM E$<20) BEFORE CALLING 
9 REM 

II REM 
13 REM 

15 FRINT”{clear!"; : F0RT=1T020: E#( I )="{40 spaces!”: 
PRINT 

17 NEXT I:X=l:L=1 

19 PRINT" ENTER PRESS 'RETURN' HERE 

i 

£1 PRINT" DEFINITION WHEN DONE EDITING, 

{home!"; 

23 GETG$: IFG$= " "THENG0SUB85 •• G0T023 
25 IFG$= ” -Co 1 ear ! "OFG$= " {home! ”THENX=1: L=1: 

PRINT"{home! ”; : G0TG23 
27 IFG$=”{insert!"THEN23 
29 IFG$="{right!”ANDL=20ANDX=40THEN£3 
01 IFG$=CHR$(13)ANDL=20ANDX=40THENRETURN 
33 IFG#="{right!"THENPRINTMID$(E$(L),X,1);: 
G0SUB67: G0T023 

35 IF G$="{up!”0RG4="{down!”THENFRINTMID$(E$(L),X, 
1)+”{1eft!";:G0SUB75:PRTNTGS;:G0T023 
37 IFNOT(X=40ANDL=20)ANDG$<>”{left!”AND- 

G$< - CHR$-( 13)ORG$=CHR$(20)THEN PRINT” {left!”; 
G$; 

39 IF G$= ’’{left!"ANDL=1ANDX=1THEN23 

41 IF G$="{left!”THENPRINTMID$(E$(L), X, 1);G$; 

’’{left!”;:G0SUB59: G0T023 
43 IFG$=CHR$(20 JTHENG0SUB55:G0T023 
45 IFG$=CHR$(13)ANDL=20THEN£3 

47 X1=0:IFG$=CHR$(13)THENPRINTMID$(E$(L),X,1); 
"{left!":X1=X:X=1 

49 IFG$=CHR$(13)ANDX1=40 THENF'RINT”{up!”; 

51 IFG$=CHR$(13)THENG0SUB77:G0T023 
53 G0SUB63:G0T023 

55 IFX=1THENE#(L) = " "+RIGHT$(E$(L),39):G0T059 
57 E$(L)=LEFT$(E$(L),X-1)+” ”+RIGHT$(E*(L),40-X) 
59 X=X-1 •- IFX < 1THENX=40: L=L-1: G0T079 
61 RETURN 

63 IFX=1THENE$(L)=G$+RIGHT$(E$(L),39):G0T067 
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65 ES(L)=LEFTS(E$< L),X-l)+G$+RIGHT$(E#(L),40-X) 

67 IFL=20THENIFX<40THENX=X+1:RETURN 
69 IFL=20THENGS=””:RETURN 
71 IFL<20THEN X=X+1:IFX>40THENX=1:G0T077 
73 RETURN 

75 IFGS= ’’-Cup! ”THENL=L-1: G0T079 
77 L=L+1 

79 IFL <1THENL=1:GS=”” 

81 IFL>20THENL=20:GS=”” 

83 RETURN 

85 B=B+1: IFB=10THENPRINTMID$(ES(L), X, 1); +”< lef t! ”; 

:RETURN 

87 IFB=20THENB=0:PRINT”{rvs on!”+MID$(E$(L),X, 

1 )+”-Crvs offKleft!”; 

89 RETURN 
91 REM 
93 REM 
95 REM 

97 REM PAD W$ TO 30 CHARS & SET IN KS 
99 REM 
101 REM 

103 KS=LEFTS(WS+”-C30 spaces!”,30): RETURN 
105 REM 
107 REM 
109 REM 

111 REM ROUTINE TO FIND ONE WORD 
113 REM 
115 REM 

117 G0SUB97:SYS64628:3,1,1,K*,L.H,S 

119 IFS=0THENKS= ’’FOUND -Crvs on!”+W$: RETURN 

121 KS=”{rvs on!”+W$+"-Crvs off! NOT FOUND”:RETURN 

123 REM 

125 REM 

127 REM 

129 REM ENTER A NEW KEY IN DICTKEYS 
131 REM 
133 REM 

135 G0SUB97:SYS64628:1,1,1,K$,L,H,S:IFS< >OTHENSTOP 
137 RETURN 
139 REM 
141 REM 

143 REM ROUTINE TO FIND FOUR SURROUNDING WORDS 
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145 F0RI=1T05:W$(I)=”-C30 spaces!”: NEXTI 
147 REM 

149 R=2:G0SUB97 

151 SYS64628:5,1,1,K$,L,H,S 

153 IFS=OTHENW$(R)=K$ 

155 R=R-1sIFR< >0THEN151 
157 R=4:G0SUB97 
159 SYS64628:4,1,1,K$,L,H,S 
161 IFS=OTHENW$<R)=K$ 

163 R=R+1:IFR<>6THEN159 

165 GGSUB111:W$(3)=K$:RETURN 

167 REM 

169 REM 

171 REM 

173 DIM E$(20): 0PEN1,8,3, ’’DICTKEYS”: OPENS ,8,2, 
’’DEFINITIONS, L, ”+CHR#(41) 

175 OPEN 15,8,15 

177 Rl=l:G0SUB209:IFE<>0THENR1=1:G0SUB209:R2=2: 

PRINTS, R2: REM INITIALIZE DEFS 
179 R1=1:G0SUB209:INPUT#2,R2 
181 REM 

183 REM GET A WORD TO LOOK UP 
185 REM 

187 PRINT: PRINT: INPUT ’’WORD TO SEARCH OR -Crvs 
on>Q-Crvs off>UIT”; W$: PRINT: IFW$= ”Q”THENSTOP 
189 GOSUB 111:IFS<>OTHENPRINT K$:G0SUB143: 

F0RI=1T05:PRINTI;” ”;W$(I):NEXT 
191 IFS=OTHENU$=”3”:PRINTK*:G0T0203 
193 IFSOO THEN PRINT”# OF WORD OR -Crvs onJA-Crvs 
off>DD WORD OR Crvs on>NCrvs off>EW WORD”; 
195 GETU$:IFU$=””THEN195 
197 IFU$=”N” THEN 187 

199 IFU$=”A” THEN PRINT:R1=R2:G0SUB209:GOSUB 129 
G0SUB235:GOTO183 

201 IFU$<”1”0RU$>”5”0RU$=”3”THEN195 
203 PRINT:U=VAL(U$):W$=W$(U):G0SUB111:R1=H*256+L 
G0SUB209:G0SUB221:G0T0183 
205 REM 
207 REM 

209 REM POSITION IN DEFS FILE 
211 REM 
213 REM 
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215 H=INT(Rl/256):L=Rl-(H*256) 

217 PRINT#15, ’T”-HCHR$(2)H<^t(L)-HCHR$(H)+CHR$(l) 
219 INPUT#15 ,E,T$,T,SjRETURN 
221 REM 

223 REM PRINT DEF FDR WORD 
225 REM 
227 PRINT 

229 INPUTO2,LI:FORI=1TOL1sINPUT#2,P$:PRINTPS;: 

NEXT:RETURN 
231 REM 
233 REM 
235 REM 
237 REM 

239 REM GET NEW DEFINITIONS 
241 REM 

243 R1=R2:G0SUB209:G0SUB3:PRINTS,0: FORI=11020 
245 IFE$( I )=”-C40 spaces!’’G0T0249 
247 PRINTS, CHR$(34)+E$( I): R2=R2+1 
249 NEXT:G0SUB209:PRINT#2,R2—R1s Rl=l:G0SUB209: 
R2=R2+1: PRINTS, R2: RETURN 
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QUICK COMMANDS REFERENCE 

DIRECT—MODE Commands 


ACTIVATE 

p. 8-1 

AUTOCOPY 

p. 8-2 

AUTODEL 

p. 8-3 

BUILD 

p. 8-4 

BUILDINDEX 

p. 8-5 

CHANGE 

p. 8-6 


erase and re-creates bam and index for existing LU 
ACTIVATE 

copy file(s) between LUs 

AUTOCOPY 

delete file(s) from LU 

AUTODEL 

create ‘formatted’ RELative file 

BUILD_filename, nrecs, reel 

builds a KEY file for indexed RELative files 
BUILDINDEX 

change file’s characteristics 

CHANGE_[lu: [filename 


CLEAR clear archive bits for file(s) 

p. 8-7 CLEAR 

CONFIG change power-up default system settings and LU parmeters 

p. 8-8 CONFIG 


COPY copy oldfilename into newfilename 

p. 8-9 COPY [“][lu:][newfilename] = [lu:]oldfileneme[“] 

D set temporary hardware device # for hard disk 

p. 8-10 D[_drynum] 


DEL delete lines of BASIC program in memory 

p. 8-11 DEL_line number or DEL_[beg.line]—[end.line] 

DI lists keys within the specified KEY file 

p. 8-12 DI 


DIRECT—MODE Commands continued 


RUN—MODE Commands 


FETCH 

p. 8-18 

create memory BASIC programs from disk resident text file 
FETCH [lu:]filename 

COPY 

p. 8-9 

copy sourcefile to destfile 

OPEN #lfn,dev, 15, “ C [lu]: dfilename = [lu: ] sfilename ’ 

ICQUB 

p. 8-19 

capture or run captured copy protected software 

ICQUB or filename 

DELETE 

p. 7-4 

key from specified directory of a KEY file 

SYS 64628:2, lfn, di rectory, String var, rec 1, rech, status 

L 

p. 8-22 

abbreviated LOAD file from disk 

L_[ “ ] [lu: ] filename [” ] 

INPUT# 
p. 7-5 

read string up to 254 chars from file 

INPUT# lfn, string var 

LOAD 

p. 8-22 

load file from disk 

LOAD “[lu:]filename”,dev[,sa] 

INSERT 

p. 7-6 

new key into specified directory of a KEY file 

SYS 64628:1,lfn,directory,Stringvar,reel,rech,status 

LU 

p. 8-23 

changed logged logical device # 

LU[_lunem] 

LOAD 

p. 7-7 

load program file from disk 

LOAD “[lu:]filename”,dev[,sa] 

MERGE 
p. 8-24 

merge disk based BASIC programs into memory program 
MERGE_[lu: ] filename 

OPEN 

p. 7-8 

open disk file for i/o 

OPEN #1 fn, dev, sa, “ [lu: ] filename 

OOPS 

p. 8-25 

recover last erased file 

OOPS 

PRINT# 

p. 7-9 

write string up to 254 chars to file 

PRINT#lfn,stringvar or PRINT#lfn, “literal string’ 

QUERY 

p. 8-26 

list characteristics of file 

QUERY_[lu: ] filename 

SAVE 
p. 7-10 

save program (or memory range) to disk 

SAVE “ [ < range > ] [lu: ]filename’ ’,dev 


RENUM renumber BASIC program in memory 

p. 8-27 RENUM[_incr[,newstart[,oldstart-oldend]]] 


SCRATCH scratch (erase) file from disk 

p. 7-11 OPEN #lfn,dev, 15,‘‘S[lu]: filename 


S 

p. 8-33 
S 

p. 8-33 

SAVE 
p. 8-34 


save & replace BASIC programs in memory under same 
name 

S 

abbreviated SAVE program or range of memory to disk 
S_[ range ][lu: filename 

SAVE program or range of memory to disk 
SAVE “[ range ][lu;]filename”,dev 


SEARCH search KEY file for key entry match, > condition, or 

p. 7-12 < condition 

Match SYS 64628:3,lfn,directory,Stringvar,reel,rech,status 

Greater-than SYS 64628:4, lfn directory, String var, reel, rech, status 
Less-than SYS 64628:5,lfn,directory,Stringvar,reel,rech,status 


SHUFFLE re-distributes keys within a directory of a KEY file for 
p. 7-13 optimum space usage within the file 

SYS 64628:7, lfn,directory,Stringvar, reel,rech, status 


DIR list directory of files on hard disk 

p. 8-13 DIR [[lu:[user:]]:[Tfiltyp][P][S][S][G][C]—][filename] 


SHIP locks head in preparation to transport hard disk 

p. 8-35 SHIP 


DUMP write editable text image of BASIC in memory to disk file 

p. 8-15 DUMP_[range_][lu:]seqfile 


TYPE list disk resident BASIC program to screen 

p. 8-36 TYPE_[lu;]filename 


ERA erase one file from disk UPDATEDOS refresh all DOS image files with new version of DOS 

p. 8-16 ERA_[lu:[user:]]filename p. 8-37 UPDATEDOS 


FASTCOPY 

p. 8-17 


fast 1541 back-up/restore utility 
FASTCOPY 


USER 
p. 8-38 


change logged subdirectory number 
USER[_user#] 


